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PREFACE 


WHO SHOULD READ THIS MANUAL 


You should read this manual if you are developing a graphics 
application for the Professional 300 Series computer and need 
information about PRO/GIDIS, the General Image Display 
Instruction Set that runs on the Professional computer. 
PRO/GIDIS is one of the tools that can be used in developing 
graphics applications for the Professional computer. 


This document is intended for programmers who have had experience 
with systems programming and graphics applications software. The 
reader also is expected to be familiar with the Professional 300 
Series Tool Kit, and either MACRO-11 or FORTRAN. 


It 1s recommended that you also read the CORE Graphics’ Library 
(CGL) Manual for a more tutorial approach to graphics software 
development on the Professional computer. 


SCOPE OF MANUAL 


This manual describes PRO/GIDIS and is intended to be used as 
both a reference manual and user guide. It covers applications 
running on the Professional and also provides programming 
information about device-independent text and graphics 
programming with PRO/GIDIS. 


ORGANIZATION OF MANUAL 


The manual has ten chapters and three appendixes. The contents 
are Summarized in the following subsections. 


Chapter 1 -- Introduction to PRO/GIDIS 


This chapter is the "user guide" for PRO/GIDIS. It provides an 
overview of PRO/GIDIS and its relationship to other graphics 
products, suggests when PRO/GIDIS should and should not be used, 
Summarizes the PRO/GIDIS instruction groups, and discusses each 
group in detail. 


Chapter 2 -- Interacting with the PRO/GIDIS Interpreter 
Describes the software interface to PRO/GIDIS. It describes the 
Queue I/O (QI0O) directives that send instructions to PRO/GIDIS 


and return GIDIS reports, and provides PRO/GIDIS programming 
syntax rules and programming examples. 
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Chapter 3 -- Control Instructions 


Details the  PRO/GIDIS instructions for program start-up, 
initialization, along with syntax-required instructions. 


Chapter 4 -- Viewing Transformation Instructions 


Describes the instructions used for mapping graphics addressable 
image areas to hardware output devices and the concepts involved 
in area transformation. 


Chapter 5 -- Global Attributes Instructions 


Details the global parameters that govern the appearance of 
drawing primitives (writing modes, line characteristics, pixel 
size, area texture, and primary/secondary color). 


Chapter 6 -- Drawing Instructions 
Describes the instructions used for drawing lines and curves. 
Chapter 7 -- Filled Figures Instructions 


Details those PRO/GIDIS instructions that provide shading for 
closed figures. 


Chapter 8 -- Text Instructions 
Describes’ the instructions that control text subsystem 
characteristics (current alphabet, character selection for 


display, unit and display sizes, cell rotation and rendition, and 
so forth). 


Chapter 9 -- Area Operation Instructions 


Details those instructions that affect the display area and _ the 
instruction for dumping screen contents to the Professional's 
printing device. 


Chapter 10 -- Report Handling 


Describes report handling instructions that return state 
information from the output device. 


Appendix A -- Instruction Summary 


Lists the PRO/GIDIS instructions, their opcodes, argument list 
lengths, and associated parameters. Also features an instruction 


list sorted into opcode order. 
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Appendix B -- DEC Multinational Character Set 


Shows the code table for the Professional's alphabet 0, the DEC 
Multinational Character Set. 


Appendix C -- Glossary 
RELATED DOCUMENTATION 
Please refer to the other manuals in the Tool Kit Documentation 


Set for more information on developing applications for the 
Professional. 


ix 


CHAPTER 1 


INTRODUCTION TO PRO/GIDIS 


PRO/GIDIS, the General Image Display Instruction Set (GIDIS), is 
one of several tools used to develop graphics applications for 
the Professional 300 Series computer. It consists of a set of 
instructions that provide the lowest-level, virtual device 
interface to the Professional's graphics hardware. 


1.1 OVERVIEW 


PRO/GIDIS is aimed at applications creating "Synthetic graphics," 
those in which images can be described using geometrical entities 
such as lines, arcs, and shaded areas. PRO/GIDIS can also be 
used to display mixed text and graphics. Figure 1-1 shows 
typical PRO/GIDIS output, a graphical representation of some 
Sample statistical data. 
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Figure 1l-l: PRO/GIDIS Sample Output 
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OVERVIEW 


PRO/GIDIS is implemented as a layer of P/OS software that 
receives and interprets binary instructions and executes them on 
the Professional's graphics hardware. The interpretation of 
instructions is dependent on the current state of PRO/GIDIS as 
well as on any explicit parameters that might be supplied with 
the instruction. Many PRO/GIDIS instructions, like those that 
control global attributes or the viewing transformation, do not 
actually cause any drawing to take place, but rather, change 
PRO/GIDIS's state. 


1.2 RELATIONSHIP TO OTHER GRAPHICS TOOLS 
The other graphics tools include: 


@e The Professional Developer's Tool Kit CORE Graphics Library 
(CGL), a library of high-level graphics subroutines based on 
the ACM SIGGRAPH CORE Standard. 


NOTE 


Do not use PRO/GIDIS and CGL in the same 
program. CGL was implemented with PRO/GIDIS 
and must have exclusive control of it for 
proper operation. 


@ ReGIS (Remote Graphics Instruction Set), a Digital-developed, 
ASCII-based protocol, is used to transmit graphics 
instructions from a host computer to a remote Professional, 
or VT125 or GIGI graphics terminal. ReGIS currently cannot 
be used by applications that reside on the Professional 
itself; it can only be used when communicating with the 
Professional over a communications line. 


PRO/GIDIS supports CGL and ReGIS and is designed to support 


Digital's future graphics products. As shown in Figure 1-2, both 
CGL and ReGIS are implemented as layers above PRO/GIDIS. 


1.2.1 WHEN TO USE PRO/GIDIS 


@e Use PRO/GIDIS if you are already well-versed in graphics 
programming. 


RELATIONSHIP TO OTHER GRAPHICS TOOLS 
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Figure 1-2: PRO/GIDIS Interface, Programs/Video Hardware 


Use PRO/GIDIS for applications that require fast execution 
speed and that can make use of its level of functionality. 
Some examples are interactive drawing packages, graphics 
terminal emulators, and scientific/engineering data display 
packages. 


Use PRO/GIDIS for applications that require efficient storage 
of images. Your program can store sequences of binary 
instructions on disk or in memory and send them to PRO/GIDIS 
for rapid display. 


Use PRO/GIDIS to implement graphics utility layers, such as 
CORE and GKS. 


Use PRO/GIDIS to implement application-specific graphics 
subroutine libraries. This provides flexibility, permits 
optimization of routines for a particular application, and 
avoids use of excessive virtual address space. 


1.2.2 WHEN NOT TO USE PRO/GIDIS 


If you are not well-versed in graphics programming, consider 
using the CORE Graphics Library instead of PRO/GIDIS. 


RELATIONSHIP TO OTHER GRAPHICS TOOLS 


@® If your program requires support for real (floating point) 
coordinates, curves, markers, and so. forth, use the CORE 
Graphics Library. 


@ If you are concerned with portability of programs’ and 
programmers, and industry-standard program interfaces’ to 
graphics routines, use the CORE Graphics Library. 


@e If you require VT125 compatibility, use ReGIS with the 
Professional Terminal Emulator. 


@® Do not mix graphics protocols. Do not use PRO/GIDIS if you 
intend to use the CORE Graphics Library and/or direct access 
to the video hardware. 


1.3 THE PRO/GIDIS INSTRUCTION SET 


PRO/GIDIS instructions are defined in the form of an mnemonic 
instruction name and accompanying arguments. Some instructions 
require no arguments; some require a fixed number of arguments; 
and some accept a variable number of arguments. Chapter 2 
describes how to construct calls to PRO/GIDIS instructions. 


The PRO/GIDIS instruction set can be divided into the following 
functionally related groups. Each group is described in detail 
in subsequent sections of this chapter. 


® Control Instructions 


These instructions initialize the PRO/GIDIS interpreter, 
begin and end pictures, set the cursor, and so forth. 


@ Viewing Transformation Instructions 


The instructions control the PRO/GIDIS address spaces and 
extents, and the mapping between them. 


@e Global Attribute Instructions 


These instructions set the PRO/GIDIS general state variables 
that control the appearance of images. 


@ Drawing Instructions 


These instructions draw the actual lines and curves that make 
up images. 


THE PRO/GIDIS INSTRUCTION SET 


Filled Figure Instructions 


These instructions draw solid figures by shading specific 
areas. 


Text Instructions 


These instructions control alphabets and draw graphics 
character text. 


Area Operation Instructions 


These instruction perform operations such as_ scrolling and 
printing on specific areas. 


Report Instructions 


These instructions cause PRO/GIDIS' to return specific 
information about the current state. 


1.4 CONTROL INSTRUCTIONS 


These are the instructions that control the operation of the 
PRO/GIDIS interpreter. 


INITIALIZE 


The INITIALIZE instruction restores power-on status to one or 
more graphics subsystems (addressing, global attributes, 
text, or all subsystems). 


NEW PICTURE 


The NEW PICTURE instruction clears the view surface _ to 
indicate the start of a new picture. 


END PICTURE 


The END PICTURE instruction indicates the end of a group of 
picture-drawing instructions. 


FLUSH BUFFERS 


The FLUSH BUFFERS instruction forces the execution of pending 
PRO/GIDIS instructions. 


CONTROL INSTRUCTIONS 


@ SET OUTPUT CURSOR 


The SET OUTPUT CURSOR instruction specifies the particular 
character or object to be used as_ the output cursor (a 
visible object used to mark the current screen output 
location). 


@ NOP 
The NOP instruction performs no operation and changes 
nothing. 


e END LIST 


The END LIST instruction indicates the end of a variable- 
length argument list. 


1.5 THE VIEWING TRANSFORMATION 


The graphical world is two-dimensional; we visualize it as a 
plane. The Cartesian coordinate system provides a convenient way 
of describing a plane. A coordinate pair specifies a discrete 
point in the form: 


X,Y 
where X is the horizontal axis and Y is the vertical axis. 
The finite area of a plane that can be specified by coordinate 


pairs is called an address space. The origin of an address space 
is (0,0). Coordinate values increase in magnitude to the right 


and downward. 
PRO/GIDIS deals with three address spaces: 
e GIDIS Output Space (GOS) 


GIDIS Output Space is the address space referenced by the 
GIDIS drawing instructions. 


@e Imposed Device Space (IDS) 


Imposed Device Space is the user-defined address space that 
provides a device-independent means of describing the view 
surface. 


THE VIEWING TRANSFORMATION 


@® Hardware Address Space (HAS) 


Hardware address space (HAS) is a fixed address space that 
reflects the characteristics of the particular graphical 
device being used. PRO/GIDIS does not allow the explict use 
of HAS coordinates. 


PRO/GIDIS maps coordinates between the three address spaces based 
on built-in and user-supplied information. This double mapping 
is called the viewing transformation (or "graphics pipeline") and 
is discussed in Section 1.5.6. , 


A specific rectangular portion of an address space is called an 
extent. PRO/GIDIS deals with three user-defined extents: 


e The Window 


The window iS an extent within GIDIS Output Space that maps 
to the viewport. 


e The Clipping Region 


The clipping region is an extent within GIDIS Output Space 
that determines which portion of the view surface is 
available for drawing. 


e The Viewport 


The viewport is an extent within Imposed Device Space that 
maps to a portion of the view surface (HAS). 


Normally, you need only be concerned with GIDIS Output Space 
coordinates. However, you must be aware that the viewing 
transformation can result in some loss of resolution, and that 
some mapping relationships will be more optimal than others. 


1.5.1 Aspect Ratios 


Aspect ratio is a way of representing the shape (the relationship 
between the horizontal and vertical dimensions) of an area. 
There are two types of aspect ratio. 


® Unit Aspect Ratio 


Unit aspect ratio is the ratio of the physical size of one 
unit in the horizontal direction to one unit in the vertical 
direction. For example, in an address space whose unit 
aspect ratio is 1l:l, a rectangle whose four sides are exactly 
one unit in length would appear perfectly square. 
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THE VIEWING TRANSFORMATION 


The logical address spaces (GIDIS Output Space and Imposed 
Device Space) have a unit aspect ratio of l:l. A physical 
address space (such as Hardware Address Space) has a unit 
aspect ratio that is dependent on specific hardware. 


@e Picture Aspect Ratio 


Picture aspect ratio is the ratio of an area's width to its 
height. In order to map extents from one address space to 
another the picture aspect ratios of the extents must match. 
Otherwise, only a portion of the lower-level extent is used. 
This is called isotropic mapping. 


For example, a window defined to be four GOS units by eight 
GOS units has a picture aspect ratio of 1:2 and would map 
perfectly to a viewport defined to be nine IDS units by 18 
IDS units. 


1.5.2 GIDIS Output Space 


GIDIS Output Space (GOS) is the device-independent, address space 
referenced by PRO/GIDIS instructions for the purposes of drawing 
an image. GOS has a unit aspect ratio of 1l:1l. GOS is bounded by 
the set of 16-bit, signed, two's-complement integers. PRO/GIDIS 
does not check for integer overflow; thus, GOS coordinates, in 
effect, "wrap around". 


NOTE 


It 1S recommended that you restrict the use of 
GOS coordinates to the range (-16384 to 16384) so 
that PRO/GIDIS can compute, without risk of 
overflow, the locations of all points required to 
draw an image. 


1.5.2.1 The Window - The window is the extent within GIDIS 
Output Space that maps to the viewport in Imposed Device Space. 
The SET GIDIS OUTPUT SPACE instruction specifies the upper-left 


corner, width, and height of the window, and thus its resolution 
and picture aspect ratio. 


You can adjust the window to match the data available to your 
application. It can be any portion of GIDIS Output Space and 
does not have to include the origin (0,0). 


THE VIEWING TRANSFORMATION 


In the viewing transformation, GIDIS isotropically maps the 
window to the viewport. If the picture aspect ratios of the two 
extents do not match, GIDIS maps the window onto the uppermost or 
leftmost portion of the viewport (see Figure 1-3). 


1600 


1400 


Figure 1-3: Isotropic Mapping: Window to Viewport 


1.5.2.2 The Clipping Region - The clipping region is a 
rectangular area in GIDIS Output Space that determines which 
portion of the view surface is accessible for drawing. In order 
for a point to be drawn on the view surface, it must lie within 
the clipping region. The SET OUTPUT CLIPPING REGION instruction 
specifies the clipping region, which is’ bounded only by the 
limits of the view surface. 


By default, the clipping region is the same as the window. The 
SET GIDIS OUTPUT SPACE instruction sets the clipping region to 
the newly specified window. That allows the window/clipping 


region to function as the extent within GOS that is "visible 
through the viewport." In other words, for some applications, you 
may find it convenient to think of the window and the clipping 
region as the same extent. 


A clipping region that is different from the window allows you to 
display portions of an image without changing the viewing 
transformation (and state variables). Changing the clipping 
region is more efficient than changing the window, viewport or 
IDS. 


THE VIEWING TRANSFORMATION 


1.5.3 Imposed Device Space 


Imposed device space (IDS) is a user-defined logical address 
Space that provides a device-independent way of describing the 
view surface of any hardware device. The SET OUTPUT IDS 
instruction specifies the size of Imposed Device Space, which has 
a fixed origin of (0,0). The size is restricted to positive 
integers ina signed, 16-bit word. 


NOTE 


It is recommended that you restrict the use of 
IDS coordinates to the range (-16384 to 16384) so 
that PRO/GIDIS can compute, without risk of 
overflow, the locations of all points required to 
draw an image. 


IDS has a unit aspect ratio of 1l:l, and itsS origin always maps to 
the upper-left corner of the Hardware Address Space. By default, 
the picture aspect ratio and resolution of IDS match that of the 
HAS. 


In the viewing transformation, GIDIS isotropically maps IDS _ to 
the hardware address space such that the specified IDS rectangle 
uses as much as possible of the HAS while still maintaining the 
desired picture aspect ratio (see Figure 1-4). Thus, if the 
picture aspect ratios of the two rectangular areas do not’ match, 
only a portion of the view surface is used. 
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Figure 1-4: Isotropic Mapping: IDS to HAS 


THE VIEWING TRANSFORMATION 


1.5.4 The Viewport 


The SET OUTPUT VIEWPORT instruction specifies a rectangular 
extent within IDS that corresponds to the window in GIDIS Output 
Space. The viewing transformation maps the window to the 
viewport and the viewport to Hardware Address Space. Thus, if 
the window and clipping region are the same, the viewport 


specifies the area of the view surface to which drawing is 
confined. 


1.5.5 Hardware Address Space 


Hardware address space (HAS) reflects the characteristics of the 
particular device being used. Although PRO/GIDIS does not allow 
the explicit use of hardware coordinates, an understanding of 


them can help you optimize the viewing transformation for your 
application. 


The Professional video monitor's Hardware Address Space is 960 
units in the horizontal dimension by 240 units in the vertical 


dimension (as shown in Figure 1-5). It's unit aspect ratio 
(width £o Nerght). 1S 2:5--0r 222.5. 
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Figure 1-5: Video Hardware Address Space 


The two 32-unit bands along the sides are not part of HAS. You 
can draw in them but to do so will make your application 
device-dependent because they do not necessarily exist on other 
devices. The 16-unit band along the bottom is not accessible for 
drawing. 


THE VIEWING TRANSFORMATION 


On a properly adjusted monochrome monitor, HAS occupieS a_=e space 
7.87 inches (horizontal) by 4.92 inches (vertical). Thus, a 
rectangle one unit by one unit in HAS coordinates would create an 
image that is 0.008 inches horizontal (7.87 / 960) by 0.02 inches 
vertical (4.92 / 240). 


On a properly adjusted color monitor, HAS occupies a space 9.45 
inches (horizontal) by 5.91 inches (vertical). Thus, a rectangle 
one unit by one unit in HAS coordinates would create an image 
that is 0.01 inches horizontal (9.45 / 960) by 0.025 inches 
vertical (5.91 / 240). 


1.5.6 The Viewing Transformation 


The process of creating an image on a view surface can be thought 
of as a two-step process, as shown in Figure 1-6. 


1. GIDIS maps GOS coordinates to IDS coordinates using’ the 
window and viewport. 


2. GIDIS maps IDS coordinates to HAS coordinates using the given 
size of IDS and the Known size of HAS. 


Thus, by establishing the window and viewport, you also establish 
the relationship of all GOS and IDS coordinates, including those 
outside the window/viewport. 
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Figure 1-6: The Viewing Transformation 


THE VIEWING TRANSFORMATION 


In effect, you change window parameters in order to "view" a 
different portion and/or scaling of Gidis Output Space. You 
change viewport parameters in order to "view" the same portion of 
GOS in a different portion of the view surface. 


Viewing transformation parameters only affect subsequently 
received GIDIS instructions. Changing the parameters does not 
affect images already visible on the view surface. In order to 
do that, you must change the mapping parameters and redraw the 
image. 


1.5.7 Addressing Pixels 


Some applications, such as a natural image display, must address 
individual pixels directly. To accomplish this, set IDS space to 
width 1920 and height 1200. The picture aspect ratio is 8:5, a 
ratio that maps to the entire screen. Pixel X (from the left) on 
row Y is IDS coordinate [X*2, Y*5]. 


There is a pixel at every X coordinate divisible by two and Y 
coordinate divisible by five. For example, [100,20], [22,15], 
and [78,505] all map directly to a pixel. PRO/GIDIS 
automatically truncates coordinates that map partway between 
pixels. For example, [101,23], [23,16], and [78,509] map to’ the 
Same pixels as the first list of coordinates. 


NOTE 


An IDS of 960 by 240 does not accomplish the same 
thing:. It would have a picture aspect ratio of 
4:1 (the unit aspect ratio is 1:1) which would 
not match the picture aspect ratio of HAS (8:5). 


1.6 DRAWING INSTRUCTIONS 


Part of the PRO/GIDIS state is a coordinate pair called _ the 
current position that corresponds to the current drawing location 
in GIDIS Output Space. The visual representation of the current 
position is the cursor. Thus, some of these instructions do not 
draw anything; they simply change the current position. 


DRAWING INSTRUCTIONS 


e SET POSITION 


The SET POSITION instruction specifies the new current 
position as an absolute location in GIDIS Output Space. 


e SET REL POSITION 


The SET REL POSITION instruction specifies the new current 
position as a point relative to (an offset from) the old 
current position. 


@ DRAW LINES 


The DRAW LINES instruction draws one or more straight lines 
starting at the current position. 


@ DRAW REL LINES 


Draws one or more straight lines starting at the current 
position. Coordinates specified are relative to the current 
position or the previous point. 


@ DRAW ARC 


Draws a section of a circle using the current position as a 
reference. 


e@ DRAW REL ARC 


Draws a section of a circle using an offset from the current 
position as a reference. 


1.7 FILLED FIGURE INSTRUCTIONS 


A filled-figure is a closed, shaded figure that can be bordered 
by either straight lines, circular arcs, or any combination of 
these. The instructions that begin and end filled figures are: 


@ BEGIN FILLED FIGURE 


The BEGIN FILLED FIGURE instruction starts a filled figure 
definition. 


@ END FILLED FIGURE 


The END FILLED FIGURE instruction ends a filled figure 
definition and causes the entire figure to be filled in with 
the current area texture. 


TEXT INSTRUCTIONS 


1.8 TEXT INSTRUCTIONS 


PRO/GIDIS text is independent from the Professional terminal 
subsystem's text mode. The instruction that draws text is: 


@ DRAW CHARACTERS 


The DRAW CHARACTERS instruction displays each of the 
characters specified by each character index in the parameter 
list. The characters are taken from the currently selected 
alphabet. 


1.9 COLOR ATTRIBUTES 


The Professional's video subsystem includes an internal bitmap 
(also Known as a raster image or frame buffer). The bitmap 
consists of one or more two-dimensional matrices of bits called 
planes. Each bitmap position controls a pixel, which represents 
a physical hardware coordinate position. 


The basic Professional bitmap has a single plane, providing one 
bit for each pixel. Because a single bit can be in one of two 
possible binary states: 0 or 1, only dark and light images are 
possible. A value of 0 specifies dark and 1 specifies light. 
The actual colors depend on the phosphors used in the monitor. 
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Figure 1-7: The Extended Bitmap Option 
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When equipped with the Extended Bitmap Option (EBO) board, the 
Professional's bitmap has three planes. The SET PLANE MASK 
instruction specifies which planes are accessible to PRO/GIDIS 
and which are "write-locked." 


Three planes provide three bits per position. Thus each position 
can contain a binary number in the range 000 to 111 (0 to 7 
decimal). This number is an index into an internal table called 
the color map, which contains descriptions of colors. 


The color map consists of eight entries, numbered 0 to 7, as 
shown in Figure 1-7. Each color map entry consists of three 
fields, red, green, and blue, that contain intensity values’ for 
each primary color in light. The SET COLOR MAP ENTRY instruction 
allows you to specify these red, green, and blue values by 
PrODOrt1ions 


By changing the contents of the color map, you can form 256 
different colors. If no color monitor is present, you can use 
the color map to form eight shades of display intensity. 


NOTE 


When you change the contents of a color map 
entry, you instantly change the color displayed 
for all pixels that were drawn with that entry. 


The red and green fields each consist of three bits and thus have 
eight possible values. The blue field has only two bits and thus 
has four possible values. The human eye is less _ sensitive to 
changes in blue than either of the other primaries. 


When drawing an image, PRO/GIDIS places a color map index into 
each pixel required by the image. The actual color map index 
placed in a particular bitmap position depends on the - previous 
contents of that pixel, the current pattern, and the writing mode 
(more information on this in the following sections.) 


The PRO/GIDIS state includes two color map index values: the 
primary CO1OE and the secondary COLOr, specified by 
SET PRIMARY COLOR and SET SECONDARY COLOR respectively. in 
general, the primary color indicates the presence of an image 
(the foreground) and the secondary color indicates the absence of 
an image (the background). 


1.10 THE WRITING MODE 


PRO/GIDIS characters, line textures and area textures each form a 
binary pattern which, for the purpose of describing the writing 


1-16 


THE WRITING MODE 


modes, we will call the “current pattern." The exact way in which 
PRO/GIDIS uses the current pattern to create images depends on 
the writing mode and the primary and secondary colors. 


Figure 1-8 shows the same line texture (which includes ON and OFF 
pixels) drawn over light and dark areas in all eight visible 
writing modes. 
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Figure 1-8: The Writing Modes Shown with Line Texture 
The writing modes are: 


@® TRANSPARENT 


In transparent mode, no actual drawing is’ done. Otherwise, 
all other drawing processes are exercised and the state 
information (particularly, the current position) 1s updated. 


The texture is ignored. Transparent mode for determining the 
current position after drawing without actually drawing the 
image. 


@ TRANSPARENT NEGATE 
This mode is identical to transparent mode. 
@ COMPLEMENT 


In complement mode, wherever the current pattern contains set 
(1) bits, PRO/GIDIS performs a bitwise inversion of the pixel 
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value (color index). For example, a pixel containing 101 
(color map entry 5) changes to 010 (color map entry 2). 
Wherever the current pattern contains clear (0) bits, no 
modifications are made. 


The purpose of complement mode is to make images "Stand out" 
from whatever has already been drawn. If the appropriate 
color map entries contain complementary colors, the image in 
the display area is effectively reversed. The original image 
can be restored by repeating the process. 


Complement mode is likely to produce seams when filled 
figures overlap. Since filled figures include their borders, 
areaS with a common border are considered to overlap. 


COMPLEMENT NEGATE 


Complement negate mode is identical to complement mode except 
that PRO/GIDIS negates the current pattern. Wherever the 
current pattern contains clear (0) bits, PRO/GIDIS performs a 
bitwise inversion of the pixel value (color index). Wherever 
the current pattern contains set (1) bits, no modifications 
are made. 


OVERLAY 


In overlay mode, wherever the current pattern contains” set 
(1) bits, PRO/GIDIS draws in the current primary color. 
Wherever the current pattern contains clear (0) bits, no 
drawing occurs. 


The purpose of overlay mode is to draw images "on top. of" 
whatever is already on the view surface. 


OVERLAY NEGATE 


Overlay negate mode is identical to overlay mode except that 
PRO/GIDIS negates the current pattern. Wherever the current 
pattern contains clear (0) bits, PRO/GIDIS draws in the 
current primary color. Wherever the current pattern contains 
set (1) bits, no drawing occurs. 


REPLACE 


In replace mode, wherever the current pattern contains’ set 
(1) bits, PRO/GIDIS draws in the primary color. Wherever the 
current pattern contains clear (0) bits, PRO/GIDIS draws in 
the secondary color. 


The purpose of replace mode is to draw images that completely 
replace whatever is already on the view surface. 
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@® REPLACE NEGATE 


Replace negate mode is identical to replace mode except that 
PRO/GIDIS negates the current pattern. Wherever the current 
pattern contains clear (0) bits, PRO/GIDIS draws in the 
primary color. Wherever the current pattern contains set (1) 
bits, PRO/GIDIS draws in the secondary color. 


@® ERASE 


In erase mode, PRO/GIDIS sets all pixels to the secondary 
color. The purpose of erase mode is to draw images by 
eraSing what is already on the view surface. 


@ ERASE NEGATE 


Erase negate mode is identical to erase mode except that 
PRO/GIDIS sets all pixels to the primary color. 


1.11 LINE AND CURVE ATTRIBUTES 


The following sections describe the PRO/GIDIS state variables 
that determine the appearance of lines and curves. 


1.11.1 Line Texture 


The SET LINE TEXTURE instruction specifies a linear bit pattern 
used for drawing lines and arcs. The line texture is used in 
conjunction with the writing mode and the primary and _ secondary 
colors to determine the value for all pixels ina line or arc. 
The line texture is wrapped around corners to provide a_ smoothly 
textured pattern. 


For example, the character "X" represents pixels drawn in_ the 
primary color and "-" represents pixels drawn in the secondary 
color. The pattern 0100110 produces a line (drawn from left to 
right) that looks like: 


-X--XxX- 


Although you specify the size of a single repetition of the line 
texture in GIDIS Output Space coordinates, that size is only an 
approximation. PRO/GIDIS actually uses the largest integral 
multiple of the pattern length that is less than or equal to the 
specified size. 


LINE AND CURVE ATTRIBUTES 


For example, assume that the line above has a size of seven and 
was drawn exactly once in seven pixels. Changing the size to 14 
uses each bit twice in succession: 


--XX----XXXX-- 


When you use a large drawing pixel, a number of pixels are 
written multiple times, potentially with both primary and 
secondary colors in either order ~* (see the SET PIXEL SIZE 


instruction.) The same example with a pixel size of two by two 
(pattern size = 14 pixels) would produce: 

- -- -X XX X- -- -- -- -X XX XX XX X- -- - 

- -- -X XX X- -- -- -- -X XX XX XX X- -- - 


where the symbols mean: 


- Secondary color written once 

-— Secondary color written twice 

-X Secondary color written once, then primary once 
X- Primary color written once, then secondary once 
XX Primary color written twice 


In replace mode, "-X" produces "X", "X-" produces -", and so 
forth, so the final result would be: 


--XX----XXXX--- 
--XX----XXXX--- 
In complement mode, "-" does nothing and "X" complements’ the 
pattern. Thus "--" does not change the pixel, "-X" and "X-" 


complements it once, and "XX" complements it twice (returning to 
the original state). The final result would be: 


--X-X---X--+--X-- 
--X-X---X---X-- 


1.11.2 Pixel Size 


The SET PIXEL SIZE instruction specifies the size of the logical 
drawing pixel, the bit pattern used to draw lines and arcs. 
Increasing the size of the logical drawing pixel widens the lines 
used to draw images. The default logical drawing pixel is one 
physical pixel. Figure 1-9 shows several different logical 
drawing pixels and lines. 


FILLED FIGURE ATTRIBUTES 


1.12 FILLED FIGURE ATTRIBUTES 


The following sections describe the PRO/GIDIS state variables 
that determine the appearance of filled figures. 


| 
Cs 


Figure 1-9: The Logical Drawing Pixel 
1.12.1 Area Texture 


The SET AREA TEXTURE instruction specifies a two-dimensional bit 
pattern that defines the appearance of filled figures. Area 
texture is specified as a character in an alphabet. 


Any arbitrary pattern (up to the maximum character size) can be 
used for area texture. For example, given alphabet 2, character 
23, (the pattern shown here): 


0 0 0 0 
0 1 0 
0) 1 0 
0 i! 0 


ror 


With area texture given as alphabet 2, character 23, and _ the 
appropriate sizes specified, the pattern drawn is: 


---xXXX---XxXxX 
-~--XXX---+xXxXX 
-~--XxXX------ 
---XxXX------ 
---XXX---xXxXxX 
~--XXX---xXX 
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where the symbols mean: 


= Secondary color 
X Primary color 


Area textures are aligned with a fixed point on the screen. so 
that no seams show if two areas overlap. (Assuming they are 
drawn with the same pattern, pattern sizes, writing mode, and 
colors.) The size of area texture cells is defined by the 
SET AREA CELL SIZE instruction. 


1.12.2 Area Texture Size 


The SET AREA TEXTURE SIZE instruction specifies the actual size 
of the area texture character. Although you specify area texture 
Size GIDIS Output Space coordinates, that size is only an 
approximation. PRO/GIDIS actually uses the largest integral 
multiple of the texture pattern that is less than or equal to the 
specified size. 


1.12.3 Area Texture Cell Size 


The SET AREA CELL SIZE instruction allows you to specify the size 
of the area texture cell, the source for the area texture. 
Generally, area texture cell size matches the cell size loaded 
from a character cell in an alphabet. For those occasions when 
the loaded cell size is inappropriate for the area texture, this 
instruction permits clipping the area cell after it is loaded 
from the character cell. 


1.12.4 Shading to a Line or Point 


PRO/GIDIS can be used to emulate shading to a line or a point 


using the filled figure instructions. Your program must 
calculate the area to be filled and issue the appropriate 
instructions. One way 1S to buffer points and generate one 
fill-area sequence for a number of points. Another is to 
determine the incremental area to be filled for each point and 
send a fill area sequence for each point. Because the area 
includes the border, unusual results (seams) can occur in 


complement mode when areas are adjacent or overlapping. 
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Filled Figure Examples 


The format for these example programs in described in Chapter 2. 


Figure 1-10: 
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Filled Figure Images 


= 2, opcode = 
height 
= 4, opcode = 


= A. 


opcode = 


3, opcode = 


= 2, opcode = 
‘alphabet’ 


use line texture for 


SET OUTPUT IDS 


SET OUTPUT VIEWPORT 


SET GIDIS OUTPUT SPACE 


SET LINE TEXTURE 


SET AREA TEXTURE 


area texture 


Filled Figure Examples 


BYTE 
eWORD 
~BYTE 
»~BYTE 
«WORD 
eWORD 
eWORD 
eWORD 
eWORD 
eWORD 
«WORD 
-BYTE 


Example 


BYTE 
eWORD 
~BYTE 
-BYTE 
»WORD 
«WORD 
BYTE 


Example 


BYTE 
eWORD 
BYTE 
BYTE 
eWORD 
»WORD 
BYTE 


Example 


~-BYTE 
«WORD 
BYTE 
-BYTE 
eWORD 
«WORD 
-BYTE 
»WORD 
~-BYTE 
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Ea As Ie ; 

340.,270. 

6 pera a les ° 

25 5%G20% ; 
1340,270, 
1840.,770. 
1340351270: 
340.,1270. 
840.,770. 
340.,270. 

-~32768. 

Oisup 32s ; 


1-2: 


Lege Fs ; 
3090 .42/0% 

Ose gS : 
See2 5% : 
3090.,/770. 

360. 

6 Beare ae : 


1-33 


Legos : 
4660.,340. 

(Pere se : 
36 pe 3% 
5090.,770. 
120. 

O77 32% ; 
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1-4: 
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56190 «71385 
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5190.,770. 

045325 ; 
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END LIST 
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0, 
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opcode 


opcode 
opcode 


opcode 


A Filled Figure Using DRAW ARC 


opcode 


opcode 
opcode 


A Filled Figure Using DRAW. 


opcode 


A Filled Figure Using DRAW LINES 


SET POSITION 


BEGIN FILLED FIGURE 
opcode = DRAW LINES 


END FILLED FIGURE 


SET POSITION 
BEGIN FILLED FIGURE 
DRAW ARC 


END FILLED FIGURE 


SET POSITION 


BEGIN FILLED FIGURE 
DRAW ARC 


END FILLED FIGURE 


SET POSITION 
BEGIN FILLED FIGURE 
DRAW REL ARC 

DRAW LINES 


END FILLED FIGURE 


A Filled Figure Using DRAW REL ARC 
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sBYTE re Ae ; length = 2, opcode = SET POSITION 

.WORD 7000.,3790. 7 

~BYTE O21 ; length = 0, opcode = BEGIN FILLED FIGURE 
»~BYTE 3442354 ; length = 3, opcode = DRAW REL ARC 

WORD 6000.,3800.,180. BS 

.BYTE 34 223. ; length = 3, opcode = DRAW REL ARC 


» WORD 6000.,5532.,-60. 
~-BYTE Us p32 


7 @ 


length = 0, opcode = END FILLED FIGURE 


Example 1-6: A Filled Figure Using DRAW REL ARC 


<BYTE Lepels ; length = 2, opcode = SET POSITION 

-WORD 890.,3770.. 7 

~-BYTE 0.,31. ; length = 0, opcode = BEGIN FILLED FIGURE 
.BYTE Bia 25% ; length = 8, opcode = DRAW LINES ~— 

.WORD 18904537 70% 7 

«WORD B90. gL7 70. 

«WORD 1690e,1770. 

» WORD 890.,3770. 

sBY LE Vege s 7 length = 0, opcode = END FILLED FIGURE 
Example 1-7: A Filled Figure Using DRAW LINES 

~-BYTE Zap os 7 length = 2, opcode = SET POSITION 

«WORD 3090...5.37'7 0% 

~-BYTE Oa ols ; length = 0, opcode = BEGIN FILLED FIGURE 
»BYTE 2555.42 5% ; END LIST terminated, opcode = DRAW LINES 
»WORD 3590 <p 2270's 7 7 

» WORD 4090.,3770. 

«WORD 2190 4,2870. 

e WORD 4290.,2870. 

e WORD 3090 %73770 

«WORD -32768. 

BYTE 0.,32. ; length = 0, opcode = END FILLED FIGURE 


Example 1-8: A Filled Figure Using DRAW LINES 


1.13 TEXT ATTRIBUTES 


The following sections describe the PRO/GIDIS state variables 
that determine the appearance of text. 


1.13.1 Alphabets 


The SET ALPHABET instruction specifies the current alphabet, 
which is used when drawing characters, defining a new character, 
Or erasing an existing alphabet in preparation for establishing a 
new alphabet. PRO/GIDIS supports up to 16 alphabets. 


P25 
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Each alphabet is a list of characters. Alphabet 0O is the DEC 
Multinational Character Set (shown in Figure 1-11) and cannot be 
modified. Alphabets 1 through 15 can contain user-defined 
characters, which are represented as a two-dimensional raster 
(bit pattern) with a specific storage size (width and height). 
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Figure 1-ll: Alphabet 0 


Characters within alphabets are referenced as a tuple (alphabet, 
character index). A character index is a value corresponding to 
the character's position in the alphabet. The first character 
has a character index of zero. Thus, an alphabet with 26 
characters would have index numbers in the range 0O to 25. 
Character indexes are unsigned, 16-bit integers. 


To create a new alphabet of user-defined characters: 


1. Use the SET ALPHABET instruction to specify the current 
alphabet. 


2. Use the CREATE ALPHABET instruction to clear any existing 
characters and to allocate storage for the new alphabet. No 
character definition can take place until CREATE ALPHABET 
executes. 7 


3. Use the LOAD CHARACTER CELL instruction to add characters to 
the alphabet. 
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For example (format described in Chapter 2): 


~-BYTE 1.,38. ;length = 2, opcode = SET ALPHABET 


«WORD live 

‘BYTE 4.,46. ;length = 4, opcode = CREATE ALPHABET 
«WORD 8% swidth (storage pixels) 

«WORD 10. height (storage pixels) 

«WORD 96. ;extent 

»WORD om ;width-type 


These instructions erase alphabet 1 and create a new alphabet of 
96 characters (numbered 0 through 95) with a storage size of 8 by 
10. The last parameter value (0) is required for PRO/GIDIS- on 
P/OS” 1d<.7% 
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Figure 1-12: Character Cell Rotation 
1.13.2 Cell Rendition 


The SET CELL RENDITION instruction specifies variations on 
characters that can be performed without selecting a new 
alphabet, yet are not related to writing colors or writing modes. 
The renditions defined for the Professional are backslant and 


italics. 
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1.13.3 Cell Rotation 


The SET CELL ROTATION instruction specifies the angle at which 
characters are to be drawn, as shown in Figure 1-12. Actual 
rotation is the nearest possible angle to that requested. 
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Figure 1-13: Character Unit Cell and Display Cell 
1.13.4 Cell Oblique 


The SET CELL OBLIQUE instruction specifies the angle between the 
width and the height of the display cell for a non-rotated 
character. When the angle is non-zero, display cells are 
parallelograms, rather than rectangles. 
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1.13.5 Cell Unit Size 


The SET CELL UNIT SIZE instruction specifies the actual size of 
the character pattern. Although you specify cell unit size in 
GIDIS Output Space coordinates, that size is only an 
approximation. PRO/GIDIS actually uses the largest integral 
multiple of the character pattern that is less than or equal to 
the specified size. 


1.13.6 Cell Display Size 


The SET CELL DISPLAY SIZE instruction specifies the size in GIDIS 
Output Space coordinates of the rectangle that contains the 
character pattern. 


The unit cell and the display cell always are aligned at their 
upper left corners (see Figure 1-13). If the unit cell is larger 
than display cell, only a portion of the character is shown. If 
the unit cell is smaller than the display cell, PRO/GIDIS draws 
the unused portion of the display cell as if the pattern 
specified clear bits. 


1.13.7 Cell Movement 


Cell movement attributes specify how the current position changes 
after each character is drawn. The SET CELL MOVEMENT MODE and 
the SET CELL EXPLICIT MOVEMENT instructions specify these 
attributes. -_ 


1.13.7.1 Movement mode - There are two ways to specify cell 
movement: implied and explicit, as shown in Figure 1-14. 


® Implied movement means that the current position moves a 
distance equal to the display cell width in the direction of 
the cell rotation. If the display cell width value is 
negative, the current position moves in the direction 
opposite to the cell rotation. 
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Implied Movement 
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Figure 1-14: Character Cell Movement 
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TEXT ATTRIBUTES 


@® Explicit movement means that the current position moves 


exactly as specified by your program in GIDIS Output Space 
coordinates. Explicit movement is not affected by the cell 
rotation. 


Implied movement can be disabled; explicit movement cannot. 
Thus, if implied movement is enabled, the cell movement is equal 
to the sum of the implied and explicit movements. 


PRO/GIDIS for P/OS V1.7 always uses local symmetry for drawing 
text and cell movement. Local symmetry preserves sizes and 
distances in the Hardware Address Space to ensure that all cells 
and spacings are the same. It also implies that the realized 


(actual) angle at which the character is drawn is used _ for 
implied movement. 


1.14 AREA OPERATIONS INSTRUCTIONS 


These instructions perform operations on areas defined by the 
viewing transformation instructions. 


e ERASE CLIPPING REGION 


Changes entire output clipping region to current secondary 
color. 


e PRINT SCREEN 


Prints a portion of the bitmap at the printer connected _ to 
the printer port. 


1.15 REPORT HANDLING INSTRUCTIONS 


Report handling instructions return information about the current 
PRO/GIDIS state as well as  success/failure reports for the 
immediately preceding PRO/GIDIS instructions. 


The report path from the PRO/GIDIS interpreter to your program 
can be viewed as a data stream. It is possible to queue several 
pending reports. (P/OS 1.7 imposes a buffer limit of 18 words.) 


Your program sends a request instruction to the interpreter, 
which creates a report and puts it in the queue. Your program 
then reads the report queue (with a Read Special Data QIO system 
directive) in the order in which the requests are made. For an 
example of a report-reading routine, refer to Chapter 2. 


REPORT HANDLING INSTRUCTIONS 


A report 1S a variable length block of words. The first word is 
a tag specifying the type of report and the number of words in 
the report. Your program must keep in synchronization with the 
report queue so that it is not reading a data word and 
interpreting it as a tag word. 


Your program also can set up an asynchronous system trap (AST) to 
be executed when a report is placed in the report queue. 


The following instructions request reports: 
@ REQUEST CURRENT POSITION 


PRO/GIDIS reports the X and Y coordinates of the current 
position. 


e REQUEST STATUS 


PRO/GIDIS returns a success or failure code for the last 
instruction executed. 


@® REQUEST CELL STANDARD 


PRO/GIDIS returns the standard character parameters (unit 
width, unit height, display cell width, and display cell 
height) for the current alphabet at the current rotation 
angle. 


CHAPTER 2 


INTERACTING WITH THE PRO/GIDIS INTERPRETER 


The P/OS Terminal Driver provides software access to PRO/GIDIS 
via the Queue I/O Request (QIO) and Queue I/O Request and Wait 
(QTOW) system directives. This chapter contains descriptions of 
the directive formats and PRO/GIDIS instruction syntax rules. 
QIO error messages are listed at the end of each description. 


Figure 2-1 depicts the instruction and parameter data path 
between your program and PRO/GIDIS. 


You can use PRO/GIDIS from MACRO-11 or any supported Tool Kit 
high-level language that supports external MACRO-11 routines. 
The recommended method is to write callable MACRO-11 routines 
that issue QIO and QIOW directives. Tool Kit FORTRAN-77 provides 
its own callable QIO and WTQIO routines in SYSLIB. 


For information on calling a MACRO-11 routine from one of the 


Tool Kit high-level languages, refer to the documentation for 
your programming language. 


2.1 THE PRO/GIDIS INTERFACE 


PRO/GIDIS instructions are sent to the graphics device with a QIO 
system directive that specifies the Write Special Data (I0.WSD) 
I/O function code. Eor low-overhead, high-speed, device 
interaction, a number of PRO/GIDIS instructions can be passed to 
the graphics device at one time. Status information returns with 
the Read Special Data (I0.RSD) I/O function call. P/OS transfers 
the instruction data to and from the graphics device according to 
the request priority and device availability. 


Programs that use PRO/GIDIS also can use the Professional VT102 
terminal emulator. Normal QIO directives (IO.WLB, IO.WVB, and so 
forth) are passed to the VT102 emulator. For more information, 
refer to the description of the Terminal Driver in the P/OS 
System Reference Manual. 


THE PRO/GIDIS INTERFACE 


Instruc. 
Data 


User Call QIO I0.WSD Block 
Application Call QIO IO.RSD 
Program Report 
Buffer 
Professional 


Operating 
System (P/OS) I/O Queue 
Terminal 
Driver 


IO.WLB and variants 
IO.WSD...SD.GDS 


VI102 
Emulator 
PRO/GIDIS GIDIS Instructions 
Interpreter | and Data 
Video 2 Keyboard 
Display 


Figure 2-1: PRO/GIDIS Data Path 


IO.RSD...SD.GDS 


On a single-plane system, both GIDIS and the VT102 emulator draw 
on the same plane and overwrite each other's data. On a 
three-plane system, the VT102 emulator only draws on plane three. 
Thus, if PRO/GIDIS modifies only planes one and two, there will 
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THE PRO/GIDIS INTERFACE 
be minimal interference. The SET PLANE MASK instruction 
Specifies which planes PRO/GIDIS can modify. 


The VT102 emulator scrolls all three planes when the scrolling 
region is set to the entire screen. Any graphics information in 


any plane scrolls with the text. If the scrolling region is 
smaller than ‘the entire screen, the VT102 emulator redraws the 
characters in their new positions. - This does not scroll or 


Otherwise affect graphics information in planes one and two but 
it erases graphics information in plane three. 


You can send an RIS (Reset to Initial State - <ESC>c) escape 
sequence to the VT102 emulator in order to reset both the VT102 
emulator and PRO/GIDIS to their initial states. PRO/GIDIS 
immediately performs an "INITIALIZE -1" instruction, clears the 


bitmap, and expects an opcode as the next word in the 
instruction/data stream. Thus, you can use RIS to ensure that 
your program and PRO/GIDIS are "in synch" when your program 
Starts up. You cannot use it arbitrarily in the middle of 


picture generation because of the global initialization effect. 


The QIO and QIOW directives are described in detail in the P/OS 


System Reference Manual. The examples in this manual show the SS 
forms for clarity. The $C and $ forms can be used as well. 


IO.WSD and IO.RSD are resolved in the normal manner for system 
symbols: the Application Builder gets them from module QIOSYM in 
SYSLIB.OLB. This works correctly in MACRO-11 but may not work 
with languages that have symbol naming restrictions. For 
example, FORTRAN-77 does not permit periods in symbol names. 


2.1.1 Write Special Data (IO.WSD) 


The write-special-data QIO function directs one or more 
instructions to PRO/GIDIS. The instructions and their associated 
parameter values are passed in a buffer that must have an even 
address. 


The MACRO-11 format for the Write Special Data QIO (or QIOW) call 
is shown below. 


NOTE 


The punctuation marks and the items in bold are 
mandatory; non-bold items are optional. Items in 
upper-case letters must be used exactly as shown. 
Items in lower-case letters must be replaced as 
described. 


THE PRO/GIDIS INTERFACE 


QIOWSS #1I0.WSD,1lun,efn,pri,isb,ast,<buffer,length,,#SD.GDS> 
lun 1s a logical unit number assigned to the terminal. 


efn is an event flag number (required with the synchronous 
walt form QIOW). 


pri is the priority (ignored but must be present). 
isb is the address of the I/O status block. 
ast is the address of the AST service routine entry point. 


buffer is the address of the buffer containing PRO/GIDIS 
instructions and parameters. 


length is the length of the PRO/GIDIS instruction/parameter 
buffer (specified as an even number of bytes in the range 
2 £6. G1258') 4 


SD.GDS is a data type parameter that indicates PRO/GIDIS output. 


The QIO system directive returns status in a special global 
variable called SDSW. Some possible values are: 


IS..SUC Successful completion 
IE.ILU Invalid logical unit number 
IE.IEF Invalid event flag number 


For a full list of error codes, refer to the OQOIO directive 
description and the terminal driver section of the P/OS System 
Reference Manual. 


When the OIO directive is successful, it can return the following 
status codes in the I/O status block. 


IO.SUC Successful completion 
IS.PND I/O request pending 
IE .ABO Operation’ aborted 
IE.DNR Device not ready 


2.1.2 Read Special Data (IO.RSD) 


The read-special-data QIO function reads reports placed in the 


report queue by PRO/GIDIS report-request instructions: 
REQUEST CURRENT POSITION, REQUEST STATUS, and 
REQUEST CELL STANDARD. These instructions are detailed in 


Chapter 10. 


THE PRO/GIDIS INTERFACE 


The MACRO-11 format for the Read Special Data QIO or QIOW call is 
shown below. 


NOTE 
The punctuation marks and the items in bold are 
mandatory. Non-bold items are optional. Items 
in upper-case letters must be used exactly as 


shown. Items in lower-case letters must be 
replaced as described. 


QIOWSS #1I0.RSD,lun,efn,pri,isb,ast,<buffer,length, , #SD.GDS> 


lun 1s a logical unit number assigned to the terminal. 


efn 1s an event flag number (required with the synchronous 
wait form QIOW). 


pri is the priority (ignored but must be present). 
isb is the address of the I/O status block. 
ast is the address of the AST service routine entry point. 


buffer is the address of the buffer to contain PRO/GIDIS' report 
data. 


length is the length of the PRO/GIDIS report buffer (specified 
as an even number of bytes in the range 2 to 8128). 


SD.GDS is a data type parameter that indicates PRO/GIDIS output. 


If there is no data available, the QIO waits until enough data to 
fill the buffer becomes available. During this wait, no IO.WSD 
(write special data) is peformed, even if the no-wait form was 
used. To avoid deadlock, the preferred method is to issue a 
QIOSW for the exact number of bytes expected after the request 
instruction is sent to PRO/GIDIS. 


The QIO system directive returns status in a special global 
variable called SDSW. Some possible values are: 


IS..SUC Successful completion 
be Dore #6) Invalid logical unit number 
EE .1 BE Invalid event flag number 


For a full list of error codes, refer to the QIO directive 
description and the terminal driver section of the P/OS System 
Reference Manual. 


THE PRO/GIDIS INTERFACE 


When the QIO directive is successful, it can return the following 
status codes in the I/O status block. 


LO .SUC Successful completion 
IS .PND I/O request pending 
IE .ABO Operation aborted 
IE.DNR Device not ready 


2.2 PRO/GIDIS INSTRUCTION SYNTAX 


The PRO/GIDIS interpreter accepts a stream OF PRO/GIDIS 
instructions consisting of operation code (opcode) words and 


associated parameter blocks. Specific delimiters are not 
required between PRO/GIDIS instructions. To ensure that the 
PRO/GIDIS interpreter handles each individual instruction 


properly, the opcode word for each instruction contains a length 
value that specifies the number of parameter words that follow 
dt | 


high byte low byte 


2.2.1 Operation Codes 


PRO/GIDIS instruction names map to specific numeric operation 
codes. For example, the INITIALIZE instruction has an opcode of 
1, while the SET PRIMARY COLOR instruction opcode is DM 
(Appendix A provides a list of PhO ere instructions and their 
corresponding numeric opcodes.) 


Your program can define PRO/GIDIS instruction names as numeric 
constants. For example, in MACRO-1l, this could be: 


GSINIT =: J. 
GSPRIM 21. 


In FORTRAN, this could be: 


INTEGER*2 GINIT,GPRIM 
PARAMETER (GINIT = 1, GPRIM = 21) 


PRO/GIDIS INSTRUCTION SYNTAX 


In PASCAL, this could be: 


CONST 
INITIALIZE = 1; 
SET PRIMARY COLOR = 21; 


2.2-2 Parameter Blocks 


Most PRO/GIDIS instructions require ae specific number Of 


parameters. For example, SET POSITION needs exactly two 
parameters. 


A length value in the range 0 to 254 indicates a fixed-length 


parameter block. For example, if you specify a length value of 


two, PRO/GIDIS expects two parameter words as shown in Example 
2-1 ® 


Some PRO/GIDIS instructions accept a variable number of 


parameters. The instructions in this category are DRAW LINES, 
DRAW REL LINES, DRAW CHARACTERS, and LOAD CHARACTER CELL. 


~-BYTE 2.,29. ;Instruction data block length = 2 
;Opcode for SET POSITION instruction = 29 

»WORD 100. Horizontal coordinate for current pos. 

«WORD 25.0% >Vertical coordinate for current pos. 
*-Following execution of this instruction, 
sthe current position is 100,550. 


Example 2-1: Instruction with Fixed-Length Parameter Block 


A length value of 255 indicates that the parameter block contains 
a variable number of parameter words terminated by an END LIST 
instruction word (-32768), as shown in example 2-2. Thus, in a 


variable-length parameter block, a parameter word cannot contain 
the value -32768. 


BYTE 255.,26.;END-LIST-term.,opcode=DRAW REL LINES 


»-WORD 10. -dxl 
«WORD =30:4 sdyt 
e-WORD 20. °“dx2 
»WORD +60. sdy2 
»WORD -32768. ;END LIST instruction opcode word 


Example 2-2: Instruction with Variable-Length Parameter Block 


This technique permits the PRO/GIDIS interpreter to handle 
erroneous or unsupported opcodes without aborting the program or 
misinterpreting subsequent opcodes. If the interpreter does not 
recognize an instruction, that instruction and any data following 


2=] 


PRO/GIDIS INSTRUCTION SYNTAX 


are ignored. After counting and discarding the erroneous 
instruction’s data, PRO/GIDIS proceeds to the next sequential 
instruction. 


NOTE 


PRO/GIDIS on P/OS V1.7 sets the status flag to 
SUCCESS when it fails to recognize an 
instruction. Future versions may set the status 
flag to FAILURE. 


An instruction with insufficient parameters is not executed at 
ro ie An instruction with extra parameters is executed as though 
the extra arguments do not exist; the extra parameters are 
skipped and not interpreted as new instructions. For example, a 
SET POSITION instruction with only one argument is ignored, while 
a SET POSITION with three arguments uses the first two arguments 
and discards the third. 


2.3 SAMPLE MACRO-11 PROGRAM 


ITOSB: » BLKW Dm 
OBUF: ~-BYTE Saar. oor ;Length=0 REQUEST CURRENT POSITION 
RBUF : - BLKW 3 


*>SEND INSTRUCTION TO PRO/GIDIS 


BCS ERROR ; DIRECTIVE FAILED 
TSTB IOSB 
BLE ERROR ;OPERATION FAILED 


7;READ THE REPORT 
QIOWSS #1I0.RSD,#5,#1,,#IOSB, ,<#RBUF, #6, ,#SD.GDS> 


BCS ERROR ;BRANCH [F DIRECTIVE FAILED 
TSTB IOSB 
BLE ERROR ;BRANCH IF OPERATION FAILED 


NEW CONTENTS OF RBUF': 

BYTE AT RBUF 2% (LENGTH ) 

; BYTE AT RBUFT1 1. 

; (CURRENT POSITION REPORT TAG) 
; RBUF+2: CURRENT X POSITION 

; RBUF+4: CURRENT Y POSITION 


=e ZG WE 


ERROR: ; Error handling routine 


SAMPLE FORTRAN PROGRAM 


2.4 SAMPLE FORTRAN PROGRAM 


INTEGER* 2 SDGDS, IOWSD, IORSD, ISSUC 


PARAMETER (SDGDS=1), (IOWSD="5410), (IORSD="6030), (ISSUC=1) 
INTEGER*2 IOSB(2), IDS, OBUF 


INTEGER*2 RBUF(3),PARLST(6) 


OBUF = 55*256+0 !OPCODE 95=REQUEST CURRENT POSITION 
!LENGTH=0 

CALL GETADR(PARLST(1),OBUF) ! ADDRESS 

PARLST(2) = 2 !LENGTH=2 BYTES 


PARLST(4) = SDGDS 


CALL WTQIO(IOWSD,5,1,0,I0SB,PARLST,IDS) 
IF (IDS.NE.ISSUC) GO TO 999 !'DIRECTIVE FAILED 
IF (IOSB(1).NE.ISSUC) GO TO 999 !IT/O REQUEST FAILED 


CALL GETADR(PARLST(1),RBUF) 


PARLST(2) = 6 !EXPECTED LENGTH OF REPORT IN BYTES 


CALL WTQIO(IORSD,5,1,0,I10SB,PARLST,IDS) 
IF (IDS.NE.ISSUC) GO TO 999 !DIRECTIVE FAILED 
IF {1OSB(1).NE«ISSUC) GO TO 999 !T/O REQUEST FAILED 


NEW CONTENTS OF RBUF: 

RBUR GL). “256 

REPORT TAG = 1%*256+2 

l = THE REPORT TAG AND 2 = LENGTH OF DATA FOLLOWING 
RBUF(2): CURRENT X POSITION IN GIDIS OUTPUT SPACE 
RBUF (3): CURRENT Y POSITION IN GIDIS OUTPUT SPACE 


999 ! ERROR FOUND 


CHAPTER 3 


CONTROL INSTRUCTIONS 


This chapter contains a detailed description of each control 


instruction. Table 3-1 lists the instructions covered in the 
Chapter. 


Table 3-1: Control Instructions Summary Chart 
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1/1 INITIALIZE subsystem-mask-value 
6/0 NEW PICTURE 
24/0 END PICTURE 
28/0 FLUSH BUFFERS 
5/6 SET OUTPUT CURSOR alphabet, index, 
width, height, offset x, offset _y 
0/0 NOP 
128/0 END LIS 


breeder alread nena tee eee at eee ene ie nani ree ata i ie a se i nee he i i aie A en ee ee ee ee ee ee ee ee ee ee ee ee ee 


3.1 INITIALIZE 


The initialize instruction restores PRO/GIDIS characteristics to 
their power-on default states. Specifically, this instruction 


sets up PRO/GIDIS device subsystem characteristics such as_ the 
color map, the primary color, secondary color, addressing, 
writing modes, and so forth. 


INITIALIZE 


Opcode: 1 Length: l 
Format: INITIALIZE subsystem-mask-value 


subsystem-mask-value is a word that specifies a set of graphics 
subsystems as shown in Figure 3-l. 


Status: SUCCESS 


The INITIALIZE instruction represents device subsystems by 
specific bits in a mask value passed to PRO/GIDIS with the 
instruction. For example, a parameter value of 4 (bit 2. set) 
restores a device's text subsystem's power-on default conditions. 
The initialize instruction mask bit settings for the various 
subsystems are shown in Figure 3-l. 


1. ee. bs D- k  O CUCOBCUlC Ce  OBSUDCOC 
sas eae ts ts a ee 


ee oe ee ee ee 


--- Global Attributes 


ee Text 
—---—— (reserved) 
SSS Color Map 
— Alphabet Storage 
------- (reserved) 
------- ih shwiet 
ea ees Cursor 


| |--- Addressing 


(Bits 8-15 are reserved) 


Figure 3-l: INITIALIZE Subsystem Initialization Bit Mask 


The PRO/GIDIS subsystems that can be selected for initialization 
are listed in Table 3-2. 


Table 3-2: Initialization Subsystems 


Subsystem Description Bit 
Addressing - Resets the viewing transformation 0 
Global - Reinitializes writing mode, primary as 
Attributes color, secondary color, line and area 


texture, planes selected, and pixel size 


INITIALIZE 


Text - Resets the current alphabet, unit size, 2 
display size, cell rotation, cell 
rendition, implicit cell movement flag, 
and explicit cell movement 


Color map - Reinitializes the color map 4 

Alphabet - Clears all user-defined alphabets 5 

Cursor - Resets the output cursor 8 
Notes: 

@® You can OR (logical inclusive) mask values together to 
initialize multiple subsystems in one instruction. 

@ A mask of -1l decimal (177777 octal) explicitly initializes 
all subsystems. 

@ The order of initialization is: (1) addressing, (2) global 
attributes, (3) text, (4) color map, (5) alphabet storage, 
and (6) cursor. 

@® Regardless of the mask word, the INITIALIZE instruction 
aborts any blocks begun with BEGIN FILLED FIGURE. 

® Table 3-3 lists all of the state variables affected and their 
values after initialization. 

@ Some state variables are included in more than one subsystem. 

Example: 
~-BYTE Legs *length=l1,opcode for INITIALIZE 
»WORD 1,.!:2.!4. addressing, global attributes, 


sand text subsystems mask bits 


Table 3-3: Initialization Variable States 
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output ids width default ids width (960) 
output ids height default ids height (600) 


output 
output 
output 
output 


gidis 
gidis 
gidis 
gidis 


output 
output 
output 
output 


curren 
curren 


output 
output 


output 
output 


line t 


area t 
area t 


logica 
TOG1LCa 
logica 
logica 


INITIALIZE 


viewport x origin 
viewport y origin 
viewport width 
viewport height 


output space x origin 
output space y origin 
output space width 
output space height 


clipping. x Origin 
clipping y origin 
clipping width 
clipping height 


t position x 
t position y 


cursor width 
cursor height 


cursor x offset 
cursor y offset 


exture size 


exture width 
exture height 


1 pixel width 

1 pixel height 

1 pixel x offset 
1 pixel y offset 


cell movement mode flag 


celle 
cell e 


cell d 
cell d 
cell u 
cell u 


xplicit movement dx 
xplicit movement dy 


isplay size width 
isplay size height 
nit size width 
nit size height 


0 

0 
default 
default 


0 
0 
default 
default 


0 
0 
default 
default 


0 
0 


ids 
ids 


ids 
ids 


ids 
ids 


width (960) 
height (600) 


width (960) 
height (600) 


width (960) 
height (600) 


Standard unit width 
standard unit height 


1/2 standard unit width 
1/2 standard unit height 


line texture length * 


standard unit width 
standard unit height 


© 


0 
0 
0 


(1 hardware pixel) 
(1 hardware pixel) 


implied movement 


0 


standard 
standard 
standard 
standard 


* converted to new GOS coordinates 


display width 
display height 
unit width 
unit height 


INITIALIZE 


Global Attributes Subsystem 
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primary color a 
secondary color 0 
plane mask 7 
writing mode overlay 


cell 
cell 


explicit movement dx 
explicit movement dy 


0 
0 


logical pixel width QO (1 hardware pixel) 
logical pixel height 0 (1 hardware pixel) 
logical pixel x offset 0 
logical pixel y offset 0 
line texture pattern solid (all ones) 
line texture length 16 (bits) 
line texture size 16 hardware pixels * 
area texture alphabet -l 
area texture char 0 
area texture width standard unit width 
area texture height standard unit height 
* converted to new GOS coordinates 

Text Subsystem 
current alphabet 0 
cell display size width Standard display width 
cell display size height standard display height 
cell unit size width standard unit width 
cell unit size height standard unit height 
cell rotation 0 
cell oblique 0 
cell rendition none 
cell movement mode flag implied movement 


INITIALIZE 


Color Map Subsystem 


color map [0] 0, .0, .0, .0 black (dark) 

color map [1] ~2, «2, «6, «2 blue (dark gray) 
color map [2] 17. ly weg wo: “red (light gray) 
color map [3] 2, «7, «2, «4 green (light) 
color map [4] 665 «by. «63% «<7 white Clight) 
color map [5] 667. «65 «65 «J “white GClight) 
color map [6] -6, .6, .6, .7 white (light) 
color map [7] <6, 26%. «6; 27° White: Clight) 
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alphabet extent [1 to 16] 0 

alphabet height [1 to 16] 0 

alphabet width [1 to 16] 0 

Cursor Subsystem 

output cursor alphabet -l 

Output cursor character index 0 

output cursor width standard unit width 
Output cursor height standard unit height 
output cursor x offset 1/2 standard unit width 
output cursor y offset 1/2 standard unit height 


3.2 NEW PICTURE 


The NEW PICTURE instruction prepares the video display for a new 
picture by clearing the screen. This instruction sets the entire 
screen to the current secondary color. (The SET SECONDARY COLOR 
instruction is described in the chapter on global attributes.) | 


Opcode: 6 Length: 0 
Formats: NEW PICTURE 
Status: SUCCESS 


For device-independent programs, it is recommended that you use 
NEW PICTURE and END PICTURE to enclose any picture-drawing 
instructions. Place instructions for pausing or requesting 
Operator interaction after the END PICTURE instruction and before 
another NEW PICTURE instruction. ~— 


NEW PICTURE 


Notes: 


@® PRO/GIDIS ignores any arguments specified with a NEW PICTURE 
instruction. 


@® The secondary color is written to the bitmap subject to the 
plane mask in effect at the time NEW PICTURE executes. 


(Refer to the SET PLANE MASK. instruction in. the chapter on 
global attributes.) 


@ NEW PICTURE clears all pixels in the bitmap including’ those 


outside the clipping region. In particular, it clears the 
32-pixel bands on both sides of the bitmap that are not part 
of HAS and not normally used. 


Example: 


SB LE O44 0% ;length=0,opcode for NEW PICTURE 


3.3 END PICTURE 


The END PICTURE anstruction causes all. internally buffered data 
to. be sent ‘6 the output device. (Refer ‘to the FLUSH BUPFERS 
instruction). Any required device output processing of a picture 


occurs here (top-of-form, wait for interactive response, and so 
LOrt.):s 


Opcode: 24 Length: 0 
Format: END PICTURE 


Status: SUCCESS 


For device-independent programs, it is recommended that you use 
NEW PICTURE and END PICTURE to enclose any  picture-drawing 
instructions. Place instructions for pausing or requesting 
operator interaction after the END PICTURE instruction and before 
another NEW PICTURE instruction. 


Notes: 


@ END PICTURE's effect on the video display is the same as the 
FLUSH BUFFERS instruction (for P/OS V1.7). 


END PICTURE 


Example: 

-BYTE O57 Gx ;length=0,opcode for NEW PICTURE 
drawing instructions 
length=0,opcode for END PICTURE 
wait for operator response 
length=0,opcode for NEW PICTURE 


more drawing instructions 


e 
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3.4 FLUSH BUFFERS 

FLUSH BUFFERS forces execution of all buffered instructions. 
Opcode: 28 Length: 0 

Format: FLUSH BUFFERS 

Status: SUCCESS 

Notes: 


@ PRO/GIDIS lgnores any arguments specified with a 
FLUSH BUFFERS instruction. 


e Issue a FLUSH BUFFERS instruction prior to any delay or wait 
for operator response’ so that all drawing instructions are 
executed before the wait. 


Example: 


~-BYTE 0.,28. ;length=0,opcode for FLUSH BUFFERS 


3.5 SET OUTPUT CURSOR 


The SET OUTPUT CURSOR instruction selects a specific character to 
be used as the program's output cursor. The output cursor is a 
visible indication of the current output position. 


SET OUTPUT CURSOR 


Opcode: 5 Length: 6 


Format: SET OUTPUT CURSOR alphabet, index, 


width, height, 
offset-x, offset-y 


alphabet specifies the alphabet containing the character or 


the special cursors indicator (-l). 
index specifies the character or special cursor. 


width specifies the width of the cursor in GIDIS Output 
Space coordinates (greater than or equal to zero). 


height specifies the height of the cursor in GIDIS Output 
Space coordinates (greater than or equal to zero). 


offset-x specifies the X offset from the top left corner of 


the cursor to the current position (range 0 to 
Width ):< 


offset-y specifies the Y offset from the top left corner of 


the cursor to the current position (range 0 to 
height). 


Status: SUCCESS if the requested character (alphabet, index) is 


defined, and width and height and coordinates are in 
range; otherwise FAILURE. 


Notes: 


The width and height (in PRO/GIDIS Output Space) are treated 
as a unit cell size; there is no equivalent of a display 
cell. When width and height are adjusted automatically to an 
integral multiple of the storage size of the character, the x 
and y offsets are adjusted by the same ratio. 


An alphabet code of -1 specifies that one of the special 
built-in cursors is to be used. For P/OS 1.7 these cursors 
are: | 


No cursor 

Implementation default (same as 1) 
Tracking Cross (small cross) 

Crosshairs (full screen width and height) 


NOR Or 


User-specified width and height are ignored when the tracking 
is used. All other values are reserved. 


SET OUTPUT CURSOR 


e If the chosen cursor is not predefined (either a especial 
cursor or a character in alphabet 0, your program must first 
define the character and then execute a SET OUTPUT CURSOR 
instruction. If the character is redefined after the 
SET OUTPUT CURSOR, the appearance of the cursor is unchanged 
until another SET OUTPUT CURSOR executes. 

@ Once the SET OUTPUT CURSOR instruction executes, the 
appearance of the cursor changes immediately. 

Example: 

~BYTE 6.545% ;length=6,opcode for SET OUTPUT CURSOR 

» WORD I sAlphabet 1 (user-defined alphabet) 

«WORD aes Character index value 
>(Assume that Alphabet 1, character-index 
72, is defined as an arrow pointing 
straight upward 

«WORD 30% ;Width of 30 

«WORD 30. Height of 30 

«WORD 4 7x offset 

«WORD Os 7y offset 
>The arrow is the new cursor with the tip 
> being at the current position. 

Example: 

-BYTE O24 9% ;length=6,opcode for SET OUTPUT CURSOR 

«WORD —l. ;PRO/GIDIS Cursor Alphabet 

«WORD a1 4 ;No cursor 

- WORD O. ;Width value of zero (ignored) 

«WORD O's ;Height value of zero (ignored) 

«WORD oe 7x offset (ignored) 

eWORD 4. 7y offset (ignored) 
3.6 NOP 
The NOP instruction performs no operation. Execution of a NOP 
has no effect on the current state of PRO/GIDIS, other than to 
set the status flag to SUCCESS. 


Opcode: 0 Length: 0 


Formats: NOP 


Status: SUCCESS 


NOP 


Notes: 


@® PRO/GIDIS ignores any arguments’ included with a NOP 
instruction. 


Example: 


~BYTE Os gO 7;length=0,opcode for NOP 


Example: 


SBYTE Zips 7;length=2,opcode for NOP 
» WORD 1540. ;private data (ignored by PRO/GIDIS) 
«WORD Vie ;private data (ignored by PRO/GIDIS) 


3.7 END LIST 


The END LIST instruction indicates the end of a variable argument 
TaSt. This instruction follows the last argument in the list. 
Those PRO/GIDIS instructions often used with a variable-length 
argument list that terminates with an END LIST instruction 
include the Following: DRAW LINES, DRAW REL LINES, 
DRAW CHARACTERS, and LOAD CHARACTER CELL. 


Opcode: 128 Length: 0 
Format: END LIST 
Status: SUCCESS 


Notes: 


® PRO/GIDIS ignores any arguments specified with an END LIST 
instruction. 


@ The code for this instruction (-32768) is invalid for any 
data in any variable argument list. Your program must ensure 
this value is never sent in a variable argument list; 
however, the code is valid as an argument for fixed-length 
instructions. When this value appears as an opcode, no 
operation is performed. For example, the point [-32768,0] 
could not be sent in a DRAW LINES instruction that terminates 
with an END LIST instruction, but could be sent in a 
DRAW LINES instruction with counted arguments. 


END LIST 


Example: 


~-BYTE 255.,25. ;length=END LIST,opcode for DRAW LINES 


WORD 100. ;DRAW LINES data 
WORD 110. ;DRAW LINES data 
WORD -32768. ;END LIST 


sNote that the length = 255 is a 
special value and does not indicate 
255 data words following, but that 
there 1s an unknown number of words 
following, to be terminated with 
the END LIST code 


=e %se RE =e ™O 


CHAPTER 4 


VIEWING TRANSFORMATION INSTRUCTIONS 


This chapter contains a detailed description of each of the 


viewing transformation instructions. Table 4-1 lists the 
instructions covered in the chapter. 


Table 4-1: Viewing Transformation Instructions Summary Chart 
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Opcode/Length Instruction Arguments 

12/2 SET OUTPUT IDS width, height 

13/4 SET OUTPUT VIEWPORT ulx, uly, width, height 
9/4 SET GIDIS OUTPUT SPACE ulx, uly, width, height 
4/4 SET OUTPUT CLIPPING REGION ulx, uly, width, height 
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4.1 SET OUTPUT IDS 


The SET OUTPUT IDS instruction specifies the width and height of 
Imposed Device Space (IDS). It also sets the window, clipping 
region, and viewport to be identical with IDs, and resets) all 
global attributes to their default values as shown in Table 4-2. 


Opcode: 12 Length: 2 


Format: SET OUTPUT_IDS width, height 


The parameters are integers greater than or equal to zero. 


width specifies the width of IDS. 


height specifies the height of IDS. 


4-] 


SET OUTPUT IDS 


Status: SUCCESS if width and height are greater than 0, FAILURE 


otherwise. 


Notes: 
e The upper left corner of IDS is always [0 gO 7 2s The 
coordinates of the lower-right corner is [width - 1, height - 
i ee 
@ When the picture aspect ratio of IDS space is not equal to 


the picture aspect ratio of the hardware address space, only 
a portion of the view surface is used. 


No drawing is done by the SET OUTPUT IDS instruction. 


It is recommended that width and height be less than or equal 
to 16384 (2 to the 14th power). This limitation ensures 
sufficient off-screen address space for accurate clipping. 


Table 4-1 lists all of the state variables affected and their 


reset. values. after ‘the SET OUTPUT IDS executes. All sizes 


are reset. 


Example: See SET GIDIS OUTPUT SPACE description. 


Table 4-2: State Variables Affected by SET OUTPUT IDS 


Variable 


IDS width 
IDS height 


viewport 
GIDIS output space 
clipping region 


current position x 
current position y 


cursor width 
cursor height 
cursor x offset 
cursor y offset 


line texture size 


area texture width 
area texture height 


Reset State 
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as specified 
as specified 


same as IDS 
same as IDS 
same as IDS 


0 
0 


standard unit width 
Standard unit height 
1/2 standard unit width 
1/2 standard unit height 


line texture length * 


Standard unit width 
Standard unit height 


SET OUTPUT IDS 


logical pixel x offset 0 
logical pixel y offset 0 
logical pixel width 0 (1 hardware pixel) 
logical pixel height O (1 hardware pixel) 


cell movement mode flag implicit, local 

cell explicit movement dx 0 

cell explicit movement dy 0 

cell display size width standard display width 
cell display size height standard display height 
cell unit size width standard unit width 
cell unit size height standard unit height 


* converted to new GOS coordinates 


4.2 SET OUTPUT VIEWPORT 

The SET OUTPUT VIEWPORT instruction specifies the viewport. 
Opcode: 13 Length: 4 

Format: SET OUTPUT VIEWPORT ulx, uly, width, height 

The parameters are integer values representing IDS coordinates. 


ulx specifies the x (horizontal) address of the origin of the 
viewport. 


uly specifies the y (vertical) address of the origin of the 
viewport. 


width specifies the width of the viewport (value must be 
greater than zero). 


height specifies the height of the viewport (value must be 
greater than zero). 


Status: SUCCESS if width and height are greater than 0, FAILURE 
otherwise. 


Notes: 
® No drawing is done by the SET OUTPUT VIEWPORT instruction. 


e If the picture aspect ratios of the window and viewport are 
not equal, only a portion of the viewport is used. 


SET OUTPUT VIEWPORT 


@® Unlike SET OUTPUT IDS and SET GIDIS OUTPUT SPACE, this 
instruction does not change any.of the state variables that 
depend on the definition of GIDIS Output Space (cell unit 
size, line texture size, and so forth). The GOS values are 
preserved. 


Example: See SET GIDIS OUTPUT SPACE description. 


4.3 SET GIDIS OUTPUT SPACE 


The SET GIDIS OUTPUT SPACE instruction specifies the bounds of 
the window in GIDIS Output Space. It also sets the output 
clipping region to coincide with the window and resets all global 
attributes to their default values as shown in Table 4-3. 


Opcode: 9 Length: 4 
Format: SET GIDIS OUTPUT SPACE ulx, uly, width, height 


The parameters are integer values representing GIDIS Output Space 
coordinates. 


ulx specifies the x (horizontal) address of the origin of the 
window. 


uly specifies the y (vertical) address of the origin of the 
window. 


width specifies the width of the window (value must be greater 
than zero). 


height specifies the height of the window (value must be greater 
than zero). 


Status: SUCCESS if width and height are greater than zero, 
FAILURE otherwise 


Notes: 
@ No drawing is done when SET GIDIS OUTPUT SPACE executes. 


® It is recommended that a maximum absolute value of 16384 (2 
to the 14th power) be used for the following: ulx, uly, 
ulx + width, and uly + height. This will allow sufficient 
off-screen address space for accurate clipping. 


SET GIDIS OUTPUT SPACE 


e Table 4-3 lists all of the state variables affected and their 


reset values after the eb GIDIS. OUTPUT SPACE instruction 
executes. All sizes are reset. 


Example: 


~BYTE De ee ;length=2,opcode for SET OUTPUT IDS 
-WORD 960. swidth 


«WORD 600. sheight (upper left corner is [0,0] and 
; lower right corner is [959,599] ) 


«BYTE 4.,13. ;length=4,opcode for SET OUTPUT VIEWPORT 
.WORD 0. : 7 7 

«WORD 0% 7;Sets the viewport to the left half 
»WORD 480. ; of the screen 

»WORD 600. : 

<DYEE 4.,9. 7;length=4,opcode SET GIDIS OUTPUT SPACE 
.WORD 0. : 7 

-WORD om -Sets GOS to 0-to-2399 in X 

»WORD 2400. -; and O0O-to-3999 in Y (all within the 


~WORD 4000. ° left half of the screen) 


Table 4-3: State Variables Affected by SET GIDIS OUTPUT SPACE 


Variable Reset State 
GIDIS output space as specified 
clipping region | Same aS window 
current position x 0 
current position y 0 
output cursor width standard unit width 
output cursor height standard unit height 
output cursor x offset 1/2 standard unit width 
output cursor y offset 1/2 standard unit height 
line texture size line texture length * 
area texture width standard unit width 
area texture height standard unit height 
logical pixel x offset 0 
logical pixel y offset 0 
logical pixel width 0 (1 hardware pixel) 
logical pixel height O (1 hardware pixel) 


SET GIDIS OUTPUT SPACE 


cell movement mode flag implied 

cell explicit movement dx 0 

cell explicit movement dy 0 

cell display size width standard display width 
cell display size height Standard display height 
cell unit size width standard unit width 
cell unit size height Standard unit height 


* converted to new GOS coordinates 


4.4 SET OUTPUT CLIPPING REGION 


The SET OUTPUT CLIPPING REGION instruction specifies the output 
clipping region in PRO/GIDIS output space coordinates. The 
output clipping region is the rectangle within which the 
PRO/GIDIS interpreter is permitted to draw on the view surface. 


Opcode: 4 Length: 4 
Format: SET OUTPUT CLIPPING REGION ulx, uly, width, height 
The parameters are GIDIS Output Space coordinates. 


ulx specifies the X (horizontal) coordinate of the upper left 
corner of the clipping region. 


uly specifies the Y (vertical) coordinate upper left corner 
of the clipping region. 


width specifies the width of the clipping region. 
height specifies the height of the clipping region 


Status: SUCCESS if width and height are greater than or equal to 
0, FAILURE otherwise 


Notes: 


@® The SET OUTPUT CLIPPING REGION instruction does not do any 
drawing. 


@ You cannot set the clipping region to an area larger than the 
output device. An attempt to do so reduces the clipping 
region to the portion that maps to the output device. If no 
portion maps, the clipping region width and height are set to 
0, and all drawing is clipped to nothing. 


SET OUTPUT CLIPPING REGION 


@e Clipping affects all drawing primitives, including those 
generating intermediate points that might be outside the 


Spaces specified. For example, circles are drawn only within 
the specified clipping region. 


e If width or height are zero, all drawing instructions are 
clipped to nothing. 


® The clipping region includes the borders. Therefore, the 
following instructions: 


SET OUTPUT CLIPPING REGION 100, 100, 300, 300 
SET POSITION 50, 100 
DRAW LINES 100, 100 


draw the pixel at [100,100], assuming this point is within 
the visible area. 


SET POSITION 100, 150 
DRAW LINES 500, 150 


draws pixels from [100,150] to [400,150] inclusive. 


Example: 
-BYTE 4.,4. ;length=4,SET OUTPUT CLIPPING REGION 
«WORD 100. *-Sets output clipping region to rectangle 
«WORD 100. swith the upper left corner at 100,100 
«WORD 400 sand the lower right corner at 500,200. 


eWORD 100. 


CHAPTER 5 


GLOBAL ATTRIBUTES INSTRUCTIONS 


This chapter contains a 


attribute instruction. 
in the chapter. 


detailed description of each global 
Table 5-l lists the instructions covered 


Table 5-1: Global Attribute Instructions Summary Chart 
Opcode/Length Instruction/Arguments 
a at SET PRIMARY COLOR color-value 
15/1 SET SECONDARY COLOR color-value 
16/6 SET COLOR MAP ENTRY map, index, red, green, blue, mono 
20/1 SET PLANE MASK plane-mask 
227 1 SET WRITING MODE mode-value 
19/4 SET PIXEL SIZE width, height, offset-x, offset-y 
17/3 SET LINE TEXTURE length, pattern, size 
14/2 SET AREA TEXTURE alphabet, char-index 
3/2 SET AREA TEXTURE SIZE width, height 
69/2 SET AREA CELL SIZE width, height 
5.1 SET PRIMARY COLOR 


The primary color generally indicates the presence of an 


On a three-plane 


image. 


bitmap system, SET PRIMARY COLOR specifies an 


ee! 


SET PRIMARY COLOR 


index into the color map. On a Single-plane system, 
SET PRIMARY COLOR instruction specifies light or dark. 


Opcode: 21 Length: l 
Format: SET PRIMARY COLOR color-value 


color-value A word that specifies a color map entry (range 0 to 


7) or a monochrome value (0 = dark, any other value 
= white). 


Status: SUCCESS 


Notes: 


@e Refer to the INITIALIZE instruction in Chapter 3 for a list 
of the power-on default colors. 


e This instruction does not draw anything on the screen or 
affect the bitmap. It affects objects drawn in primary color 
after the instruction executes. 


Example: 


SB Y IE 1.,21. ;length=1l,opcode for SET PRIMARY COLOR 
»WORD 4. -defines primary color as color number 4 


5.2 SET SECONDARY COLOR 


The secondary color generally indicates the absence of an image. 
On a three-plane bitmap system, SET SECONDARY COLOR specifies an 
index into the color map. On a single-plane system, 
SET: SECONDARY COLOR -imstruction specifies. laight or: dark. 


Opcode: 15 Length: l 


Format: SET SECONDARY COLOR color-value 


color-value A word that specifies a color map entry (range 0 to 
7) or a monochrome value (0 = dark, any other value 
= white). 


statuss SUCCESS 


SET SECONDARY COLOR 


Notes: 


@ Refer to the SET COLOR MAP ENTRY description in this chapter 
for a list of the power-on default colors. 


e® This instruction does not draw anything on the screen or 


affect the bitmap. It affects objects drawn in the secondary 
color after the instruction executes. 


Example: 


‘BYTE 1.,15. ;length=1,opcode for SET SECONDARY COLOR 
«WORD 1% ;defines secondary color as number 1 


5.3 SET COLOR MAP ENTRY 


The SET COLOR MAP ENTRY instruction specifies the contents of a 


particular color map entry, assuming that the EBO is present. 
All images that were drawn using that color map entry are 
immediately affected. 


Opcode: 16 Length: 6 
Format: SET COLOR MAP ENTRY map, index, red, green, blue, mono 
map an integer representing a specific color map. For the 
Professional, this value must be O to represent the 


Professional's only map. 


index an integer in the range 0 to 7 representing one of the 
eight color map entries. 


red an integer in the range of 0 to 65535 representing the 
proportion of red. 


green an integer in the range of 0 to 65535 representing the 
proportion of green. 


blue an integer in the range of 0 to 65535 representing’ the 
proportion of blue. 


mono an integer in the range of 0 to 65535 representing the 
proportion of monochrome. 


Status: SUCCESS if map = 0 and index is in the range 0 to 7. 


SET COLOR MAP ENTRY 


For convenience, the following table shows proportional values in 
the form of octal fractions. Because programming languages vary, 
the equivalents are shown as octal, unsigned decimal, and signed 
decimal constants. 


Table 5-2: Color Map Values for the Professional 
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Octal Octal Decimal Decimal 

Fraction* Integer Integer Integer 

(Unsigned) (Signed) 
0.0 0 0 0 
O.1 20000 8192 8192 
O32 40000 16384 16384 
0.3 60000 24576 24576 
0.4 100000 32768 -32768 
0.5 120000 40960 -24576 
0.6 140000 49152 ~16384 
0.7 160000 57344 -8192 


* Only the even numbers are useful for blue values: 


(0.0,0.2,0.4, and 0.6). 
Notes: 


e This instruction is not useful with a single-plane bitmap 
(non-EBO) device. 


@ No change occurs in the bitmap when SET COLOR MAP ENTRY 


executes, but every pixel drawn with the specified index 
changes color instantly. 


Example: 


sBYTE 6.,16. ;length=6,opcode for SET COLOR _MAP ENTRY 
«WORD 0. >PRO's bitmap (value must be 0) 

«WORD Je Color index 1 

»WORD 20000 *Red is one-eighth (octal) 

«WORD 40960. ;Green is five-eighths (unsigned decimal) 
»WORD 16384. ;Blue is one-quarter 

«WORD —-32768. ;Monochrome is one-half (signed decimal) 


5.4 SET PLANE MASK 


The SET PLANE MASK instruction specifies which bitmap planes are 


accessible to the PRO/GIDIS interpreter. The interpreter cannot 
modify a plane unless that plane has been designated modifiable 
with a SET PLANE MASK instruction. 


5-4 


SET PLANE MASK 


Opcode: 20 Length: l 


Format: SET PLANE MASK  plane-mask 


plane-mask An integer bit mask representing a combination of 


bitmap planes (as shown below). A set (1) bit 
indicates an accessible plane. 


Status: SUCCESS 


The following table shows all combinations that can be 
represented by plane mask (n) values. It also shows’ the 


effective writing indexes for each combination, assuming that all 
"write-locked" planes are clear. 


Table 5-3: Plane Mask Values 


n Plane 3 Plane 2 Plane 1 Writing Indexes 

0 - - - none 

g - = X 05, 1 

2 = X - Oy: 2 

3 = X X Oo, Le 27-3 

4, X - - O, 4 

S: X _ X Oy: Ly. 45 3 

6 X X - 0); 2;- 4p. 6 

d X X X Oy da iz, oe 4337 OK 7 
X = accessible to PRO/GIDIS 


- = not accessible to PRO/GIDIS 


Notes: 
@ SET PLANE MASK does not affect the video display. 


e Write-locked planes change the effects of the writing modes. 
See SET WRITING MODE for details. 


e The Professional VT102 emulator uses plane 3 for texts Reter 
to Chapter 2 of this manual and the Terminal Subsystem Manual 
for more information. 


SET PLANE MASK 


The color map can be used in combination with the color mask 
to prepare separate images in separate planes for switching 
back and forth quickly. For example: 


; Set all color map entries to dark 


~-BYTE Peo Os ;len=l1,opcode for SET PLANE MASK 


«WORD A ;plane 1 
; ;draw image A in plane 1 
: 7;Set map entries 1, 3, 5, and 7 to light 
. ;Image A appears 


BYTE Lg 2 Os 7len=l,opcode for SET PLANE MASK 


»WORD Le ;plane 2 
; 7;draw image B in plane 2 
;: *-Set map entries 1, 3, 5, and 7 to dark 
; ;Image A disappears 
: -Set map entries 2, 3, 6, and 7 to light 
° ;Image B appears 


Although drawing image B might take a while, depending on the 
complexity of the image, it will appear all at once. You can 
continue flipping images A and B very quickly. In other 
words, you can draw B while A is being viewed and so forth. 


This technique requires careful coordination of the color 
map. In order for the contents of one or more planes to have 
no effect on the visible image, certain color map entries 
must be set identically: 


"Invisible" 
Planes Color Map Entry Sets 


none CO). Ch) C2 yo) CA Cay: Cod 074 
1 (0,1) (2,3) (4,5) (6,7) 
(0,2) (1,3) (4,6) (5,7) 


ee 


3 Oe) hyo) A276) (357) 
1,2 (0,1,2,3) (4,5,6,7) 

1,3 (O,1,4,5) (2,3,6,7) 

2,3 (0,2,4,6) (1,3,5,7) 
1,2,3 (Oy Le 23 4e 5 Og) 


3=6 


SET PLANE MASK 


Example: 


~-BYTE 1.,20. ;length=1l,opcode for SET PLANE MASK 
»WORD “BO1I1 Enables GIDIS access to planes 1 and 2 
*Plane 3 1S write-protected 


5-5 SET WRITING MODE 


The SET WRITING MODE instruction defines how PRO/GIDIS writes 


images to the bitmap. See Chapter 1 for a description of the 
writing modes. 


Opcode: 22 Length: 1 
Formats: SET WRITING MODE mode-code 


mode-code Specifies one of the following integer values: 


TRANS PARENT 
TRANSPARENT NEGATE 
COMPLEMENT 
COMPLEMENT NEGATE 
OVERLAY 

OVERLAY NEGATE 
REPLACE 

REPLACE NEGATE 
ERASE 

ERASE NEGATE 


WOMANI HDU PWNHE © 
Holl 


Status: SUCCESS if a valid mode is requested; FAILURE otherwise. 


Notes: 


® No drawing is done when the SET WRITING MODE instruction 
executes. 


Example: 


~BYTE rer ;length=1l,opcode for SET WRITING MODE 
«WORD 6. -Specifies REPLACE writing mode 


5.6 SET PIXEL SIZE 


The SET PIXEL SIZE instruction permits you to increase the size 
of the logical pixel used for drawing lines. 


Opcode: 19 Length: 4 


SET PIXEL SIZE 


Format: SET PIXEL SIZE width, height, offset-x, offset-y 


The parameters are GIDIS Output Space coordinates. 


offset-x 


offset-y 


width 


height 


Specifies the logical drawing pixel width. 
specifies the logical drawing pixel height. 


specifies the X offset from the top left corner of the 


pixel to the current position. 


Specifies the Y offset from the top left corner of the 


pixel to the current position. 


Status: SUCCESS if width and height are greater than or equal to 
zero, offset 


x 1S greater than or equal to zero and not 
less than width, 


and offset y is greater than or equal to 


zero and not greater than height. 


The default drawing point is one physical pixel, and, by 


are drawn one pixel wide. 


maps to a size smaller than a hardware pixel 
hardware pixel size. In particular, width = 0 
always sets the drawing pixel to the hardware 


The drawing pixel is always a rectangle orthogonal to the xX 


Complement writing mode can produce unexpected results, as 
can replace mode uSing line texture. 


No drawing is done when the SET PIXEL SIZE function executes. 


SET PIXEL SIZE 1s used in drawing lines and arcs and in the 
WRITE PIXEL ARRAY Instruction: 


Notes: 
@ 
default, lines 
® Any value that 
is set to a 
and height = 0 
pixel size. 
® 
and Y axes. 
® 
® 
@ 
Example: 
ae eb aly 4.,19. 
«WORD 6. 
«WORD 6. 
«WORD 3 
»WORD ce 


;length=4,opcode for SET PIXEL SIZE 
;width in GIDIS output space units 
;Height in GIDIS output space units 
;Centered horizontally 

7;Centered vertically 


SET LINE TEXTURE 


5.7 SET LINE TEXTURE 


The SET LINE TEXTURE instruction defines the line texture, a bit 
pattern that is repeated in drawing lines and arcs. 


Opcode: 17 Length: 3 
Format: SET LINE TEXTURE length, pattern, size 


length the length (in bits) of the selected pattern. The 
length parameter must be less than or equal to 16. 


pattern a binary line pattern (ones and zeroes). PRO/GIDIS 


begins the pattern by using the low-order (rightmost) 
bit O first. 


size specifies the length (in GIDIS output space coordinates) 


of one repetition of the pattern. Size must be greater 
than zero. 


Status: SUCCESS if length in a range of 1 to 16, and if size is 
greater than 0, FAILURE otherwise. 


Notes: 


@® Size is used in a similar manner as the unit size for 
characters is used for text. Effective size is an integral 
multiple of the pattern length in physical pixels. 


@e The pattern length is repeated every size units in the 
display. The low-order bit is used first, then successively 
higher order bits. The pattern is rotated as lines are 


drawn, so that the pattern is preserved around corners and 
bends. 


® For the Professional, the size given is used for horizontal 
and vertical lines. Diagonal lines have a size that is 
larger by a factor of the square root of 2 (1.414...) 


e Pixel size does not change the 'size' in which the pattern 
repeats, although the appearance of the line does change. 


@ The only way to reset the texture to the original is to issue 
another SET LINE TEXTURE instruction. 


@ No drawing is done by the SET LINE TEXTURE. 


SET LINE TEXTURE 


isxample: 


»BYTE io are Se ;length=3., opcode for SET LINE TEXTURE 

»WORD B4 ;Length of pattern 

e WORD “B1OOO1l111 ;ON, ON, ON, ON, OFF, OFF, OFF, ON 
*-Bits are used in order low to high 

e WORD T00: *Size of one repetition of pattern in 
>GIDIS output space 


5.8 SET AREA TEXTURE 
SET AREA TEXTURE specifies a two-dimensional bit pattern that 
defines the appearance of filled figures. Area texture is 
specified as a character in an alphabet. Any arbitrary pattern 
(up to the maximum character size) can be used for area texture. 
Opcode: 14 Length: 2 

“crmat: SET AREA TEXTURE alphabet, char-index 


alphabet Specifies the number of the alphabet containing’ the 


texture character. It can be the DEC Multinational 
character set (alphabet 0), a user-defined alphabet, 
or the special texture indicator "-l1". 


char-index The index of the specific character or special 
texture. 


Status: SUCCESS if the specified character (alphabet, char-index) 
is defined. 


xsotes 


The alphabet number is explicitly specified and does not 
depend on the current alphabet selected by the SET ALPHABET 
instruction. 


#» If the character is re-defined after this function, the 
appearance of future filled areas is according to the old 
definition. In other words, the current pattern is copied to 
a special area texture cell at the time SET AREA TEXTURE 
executes. 


Alphabet -l is reserved for implementation-defined area 
textures. Alphabet -l char-index 0 is derived from the line 
texture (the pattern is drawn vertically and replicated 
horizontally) when the instruction executes. The texture 
Size is taken from the line texture size, not from the area 
texture width and height. 


SET AREA TEXTURE 


e The pattern always appears orthogonal to the axes; there is 
no way to rotate the pattern. 


@e Area textures are self-aligning. When two adjacent or 
overlapping areas are filled, the appearance shows no seams. 
An exception occurs in complement and complement-negate modes 
where overlapping areas collide. Areas that overlap are 


drawn twice in these modes. 
@® Pixel size is not used when filling areas. 
e No drawing is done when SET AREA TEXTURE executes. 


Example: 


~BYTE 2 ple 7length=2., opcode for SET AREA TEXTURE 
«WORD om ;User-defined alphabet 2 
»WORD 23% 23rd character 


5.9 SET AREA TEXTURE SIZE 


The SET AREA TEXTURE SIZE instruction specifies the actual size 
of texture character displayed; the size is specified in GIDIS 


output space. Character pattern is mapped completely to this 
size. 


Opcode: 3 Length: 2 
Format: SET AREA TEXTURE SIZE width, height 
The parameters are GIDIS Output Space coordinates. 


width specifies the width of one repetition of the area texture 
pattern. 


height specifies the height of one repetition of the area 
texture pattern. 


Status: SUCCESS if width and height are greater than zero, 
FAILURE otherwise. 


Notes: 


e The area size is restricted to an integral multiple of the 
texture pattern. PRO/GIDIS uses the largest available size 
that is not larger than the size specified. If no available 
size is small enough, the smallest available is used. 


SET AREA TEXTURE SIZE 


e This instruction does not affect the pattern used. 
@ No drawing is done when SET AREA TEXTURE SIZE executes. 
Examples: 
sBYTE: 2ey3 ;length=2., SET AREA TEXTURE SIZE 
«WORD M2 Area texture width = 12 units 
» WORD 8. ;Area texture height = 8 units 


5.10 SET AREA CELL SIZE 


The 


SET AREA CELL SIZE instruction allows you to _ specify a 


particular size for the area texture cell, the source for the 
area texture. 


Opcode: 69 Length: 2 


Format: SET AREA CELL SIZE width, height 


width The width (in storage pixels) for the area cell. The 


width value must be in a range of 1 to 16. 


height The height of the area cell in storage pixels. The 


height value must be ina range of 1 to 16. 


Status: SUCCESS if both width and height are in the 1-16 range, 


otherwise, FAILURE. 


Notes: 


When a character cell is loaded into the area cell, PRO/GIDIS 
clears the remainder (if any) of the area cell bits. Thus, 
if a subsequent SET AREA CELL SIZE instruction increases’ the 
area cell size, the new pattern is all zeros. 


The SET AREA TEXTURE instruction sets the area cell size from 
that of the character cell, overriding any previous 
SET AREA CELL SIZE specification. 


No drawing is done when this instruction executes. 


Examples: 


BYTE 
~WORD 
-WORD 


~-BYTE 
~WORD 
~WORD 


SET AREA CELL SIZE 


2.,14. ;Length=2, opcode for SET AREA TEXTURE 

2% -User-defined alphabet 2 (assume 8 by 10) 

23 ;Character 23 
- Area Cell Size is now 8 by 10 

2.,69. ;Length=2, opcode for SET AREA CELL SIZE 

oe sarea cell width = 9 storage pixels 

D3 ;area cell heighth = 9 storage pixels 
;Area cell size is now 9 by 9, padded on 
sthe right, with one column of OFF's, and 


swith the bottom row of the character 
-cell removed 


CHAPTER 6 


DRAWING INSTRUCTIONS 


This chapter contains a detailed description of each PRO/GIDIS 


drawing instruction. Table 6-1 lists the instructions covered in 
the chapter. 


Table 6-l: Drawing Instructions Summary Chart 
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29/2 SET POSITION <y. ¥ 

30/2 SET REL POSITION dx, dy 

25/n DRAW LINES pV 

26/n DRAW REL LINES dx, dy 

2373 DRAW ARC xX, VY, angle 
2/73 DRAW REL ARC dx, dy, angle 
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6.1 SET POSITION 


The SET POSITION instruction specifies a new current position as 
an absolute position in GIDIS Output Space. 


Opcode: 29 Length: 2 
Format: SET POSITION X, VY 
x Specifies the new X (horizontal) value of the current 


position in GIDIS output space 


6-1 


y 


Status: 


Notes: 


SET POSITION 


Specifies the new Y (vertical) value of the current 
position in GIDIS output space 


SUCCESS 


@e No drawing is done when SET POSITION executes. 


Example: 


~-BYTE 2.,29. ;Length=2, opcode for SET POSITION 


«WORD 100. ;New current position 
.» WORD 350% -is [100,350] 


6.2 SET REL POSITION 


The SET_ 


REL POSITION instruction specifies a new current position 


as an offset from the old current position in GIDIS Output Space. 


Opcode: 
Format: 


dx 


dy 


Status: 


Notes: 


30 Length: 2 
SET REL POSITION dx, dy 


Specifies an offset from the current xX (horizontal) 
position in GIDIS output space 


Specifies an offset from the current Y (vertical) 
position in GIDIS output space 


SUCCESS, provided no arithmetic overflow occurs; on 
overflow, FAILURE (position does not change) 


@ No drawing is done when SET POSITION executes. 


@ Global symmetry 1s preserved; SET REL POSITION [Dx,Dy] is 
always same as a 'SET POSITION [Current _x + Dx,Current _y + 


Dy | ' 


Example: 


*Current position is [100,350] 
~-BYTE 2 6p 30% ;Length=2, opcode for SET REL POSITION 
«WORD 100. ;Relative position is 
»WORD -50. -{[+100,-50] 

;New current position is [200,300] 


DRAW LINES 


6.3 DRAW LINES 


The DRAW_LINES instruction draws a series of straight line 
segments, Starting at the current drawing position. The end 


point of each line segment is specified as absolute coordinate 
pairs, expressed in GIDIS output space. 


Opcode: 25 Length: n 


Format: DRAW LINES xl, yl, x2, y2, 


xl Specifies the X (horizontal) value of the first line's 
end point in GIDIS output space. 


yl Specifies the Y (vertical) value of the first line's’ end 
point in GIDIS output space. 


x2 Specifies the X (horizontal) value of the second line's 
end point in GIDIS output space. 


y2 Specifies the Y (vertical) value of the second line's end 
point in GIDIS output space. 


Status: SUCCESS, provided no filled figure table overflow occurs; 
on overflow, FAILURE (position does not change) 


Notes: 


@e The coordinates can be specified either in a counted argument 
list (with the count supplied with the opcode word, or in an 
END LIST terminated list with 255 in the opcode word, as 
described in Chapter 2 of this manual. 


e® If there is an X coordinate with no Y coordinate, the lone X 
coordinate is ignored with no error indication. 


@e The DRAW LINES instruction is affected by the following 
global attributes: writing mode, primary color, plane mask, 
secondary color, pixel size, line texture, and filled figure 
flag. (See Note 4.) 


@e The way the coordinate parameters are used depends on_ the 
filled figure flag. When the filled figure flag yields 
FALSE, this instruction draws a straight line from the 
current position to the specified point. Then, the current 
position is changed and the specified point becomes the new 


current position. The next line is drawn from this new 
position to the location, specified by the next parameter 


pair. 


DRAW LINES 


e In complement and complement negate mode, common points (last 
pixel in one line, first pixel in the next) are drawn only 
once. The first pixel of a line is skipped and the last 
pixel is drawn. If the first pixel is the last pixel, the 
pixel is drawn. 


@ When the filled figure flag yields TRUE, this instruction 
Saves the given points in the filled figure table. No 
drawing is done; however, current position changes and is set 
to each specified (x, y) point. When the instruction 
completes, the current drawing position is located at the 
point indicated by the last parameter pair. When the filled 
figure table is full, coordinate pairs are ignored, and 
status is set to FAILURE. 


@ DRAW LINES modifies the bitmap only inside the clipping 
region. 


Example: 


s-Not in a filled figure definition 
;(filled figure flag is FALSE) 
Current position is [200,300] 
~-BYTE 2.,25. ;Length=2, opcode for DRAW LINES 
»WORD E50. Draw a line from [200,300] 
«WORD 200. sto [150,200] 
;New current position is [150,200] 


Example: 


scurrent position is [150,200] 
;not in a filled figure definition 
~-BYTE 4.,25. ;Length=4, opcode for DRAW LINES 


«WORD 600. xl 
«WORD =10 5 7yl 
-WORD 300. ie as 
.WORD +10. 7y2 


Draw lines from [150,200] to [600,-10] 
sthen from [600,-10] to [300,10] 

;New current position is [300,10] 

sNote that both the -10 and the +10 are 
sabsolute coordinates. 


DRAW LINES 


Example: 


;Ccurrent position is [300,10] 
snot in a filled figure definition 
»-BYTE 255.,25.;END LIST-terminated,opcode = DRAW LINES 


»WORD 400. 2x 
»WORD 4Q. -yvl 
»-WORD 700. x2 
-WORD -32768. ;ENDLIST terminator value 


;Draws a line from [300,10] to [400,40] 
;New current position is [400,40] 
7(Note that PRO/GIDIS ignores the x2 
;coordinate with no corresponding y2.) 


Example: 


;Inside a filled-figure definition 
; (Filled figure flag is TRUE) 
;Current position is not used 
; by this instruction 

‘BYTE 4.,25. ;Length=4, opcode for DRAW LINES 


»WORD 300. 2x4 
-WORD 200. 7yl 
-WORD 300. x2 
- WORD 300. 7y2 


;The points [300,200] and [300,300] are 
;added to the filled figure table 
;new current position is [300,300] 


6.4 DRAW REL LINES 


The DRAW REL LINES instruction draws a series of connected line 
segments, starting at the current drawing position. The end 


point of the first line segment is specified relative to the 
current position, and the end points of any following line 
segments are relative to the preceding segment's end point. 
Opcode: 26 Length: n 

Format: DRAW REL LINES dxl, dyl, dx2, dy2, ... 


dxl Specifies the X offset (horizontal) value of the first 
line's end point in GIDIS output space. 


dyl Specifies the Y offset (vertical) value of the first 
line's end point in GIDIS output space. 


dx2 Specifies X offset (horizontal) value of the second 
line's end point in GIDIS output space. 


6-5 


dy2 


Status: 


Notes: 


DRAW _ REL LINES 


Specifies the Y offset (vertical) value of the 
line's end point in GIDIS output space. 

Additional coordinate pairs specify relative end 

for additional lines. 

SUCCESS, provided no last pair arithmetic overflow 


filled figure table overflow occurs; on overflow, 


(position is indeterminate). 


Please refer to the notes for DRAW LINES. 


Example: 


Example: 


~-BYTE 
eWORD 
eWORD 
eWORD 
»WORD 


-BYTE 
»WORD 
»WORD 
~WORD 
»WORD 
»WORD 


4.,26. 
+10. 
-10. 
+30. 
+15 


206 20% 


10. 
-30. 
20% 
+60. 
-32768. 


;Not in a filled figure definition 
(filled figure flag is FALSE) 
;Current position is [100,100] 
;Length=4, opcode for DRAW REL LINES 
7ax1 

;dyl 

ES. e- 

;dy2 

“Draw lines from [100,100] to [110,90] 
sand from [110,90] to [140,105] 

;New current ‘position is [140,105] 


;Current position is [140,105] 
snot in a filled figure definition 
; END-LIST-term. ,opcode=DRAW_ REL LINES 
;dxl 
-dyl 
rue. 
7dy2 
;END LIST 
*-Draw lines from [140,105] to [150,75] 
sthen to [170,135] 


;New current position is [170,135] 


second 


points 


FATLURE 


DRAW REL LINES 


Example: 


;Inside a filled-figure definition 
; (Filled figure flag is TRUE) 
;Current position is [100,100] 

~-BYTE 5-,26. ;Length=5, opcode for DRAW REL LINES. 


eWORD 100. edxl 
«WORD om ;dyl 
»WORD os 7axZ 
»WORD 100. say2 
eWORD 79. 2ax3 


;Adds the points [200,100] and [200,200] 
;to the filled figure table 

;New current position is [200,200] 
;Since there is no dy3, dx3 is ignored 


6.5 DRAW ARC 


The DRAW_ARC instruction draws a circular arc from the current 
position around the specified center. Direction of the arc is 
determined by the sign of the angle parameter. For example, a 
DRAW ARC 105,105,-90 instruction would draw a quarter-circle 
starting at the current position, using location 105,105 as_ the 
center of the arc's circle. Because the angle's sign is 
negative, the arc drawn would be clockwise from the current 
position. 


Opcode: ‘23 Length: 3 
Format: DRAW ARC x, y, angle 


x Specifies the X (horizontal) value of the arc’s center 
point in GIDIS output space. 


y Specifies the Y (vertical) value of the arc's’ center 
point in GIDIS output space. 


angle The angle is given in degrees, with a positive value 


meaning counter-clockwise with respect to the physical 
screen. 


Status: SUCCESS provided angle is within a range of -360 to +360 


and there is no filled figure table overflow, otherwise 
FAILURE. 


DRAW ARC 


Notes: 


An angle of zero means no drawing is done; +/-~ 360 means a 
full circle. Values greater than 360 (or less than -360) are 
errors, and no arc is drawn. 


If the filled figure flag is TRUE then, instead of drawing 


the arc, all internally calculated interpolation points are 
added to the filled figure table. 


The current position is left at the end of the arc. 


DRAW ARC is affected by the following global attributes: 
writing mode, primary color, plane mask, secondary color, 
pixel size, line texture, and filled figure flag. 


In P/OS 1.7, the PRO/GIDIS interpreter calculates one 
interpolation point per 10 degrees of arc (or portion), 
regardless of the size of the circle. 


Full quadrant arcs always end at the exact point expected. 
Fractional quadrant arcs end at the closest available point, 
which might not be precisely correct. Multiple fractional 
quadrant arcS are not guaranteed to end at the exact point 
predicted by your program. For example, a full circle of a 
103 degree arc and a 257 degree arc is not guaranteed to 
leave the current position exactly where it started. 


DRAW ARC modifies the bitmap only inside the clipping region. 


Example: 


Not in a filled figure definition 

(filled figure flag is FALSE) 

-Current position is [500,300] 
BYTE Carey ae a ;Length=3, opcode for DRAW ARC 


» WORD 400. :x coordinate of center 
«WORD 300. ;y coordinate of center 
«WORD 180. -180 degrees is one-half a circle 


* (counter-clockwise) 

*-Draws the top half of the circle 
centered at [400,300] with radius 100 
Middle of the arc is [400,200] 

sNew current position is [300,300] 


Example: 


DRAW ARC 


;Inside a filled-figure definition 

; (Filled figure flag is TRUE) 

;Current position is [500,300] 
-BYTE Bey Zo ;Length=3, opcode for DRAW ARC 


~WORD 400. Center is [400,300] 
»WORD 300. 
eWORD -90. 790 degrees = 1 quadrant 


;Adds nine interpolation points 
;(internally calculated) 

;to the filled figure table 

;Last point added is [400,400] 
;New current position is [400,400] 


6.6 DRAW REL ARC 


The DRAW REL ARC instruction draws a circular arc from _ the 


current 
current 


degrees. 


position around the center, specified relative to the 
position. Length of the arc is specified by an angle in 
Direction of the arc is determined by the sign of the 


angle parameter. 


Opcode: 
Format: 


dx 
dy 
angle 


Status: 


Notes: 


27 Length: 3 
DRAW REL ARC dx, dy, angle 


Specifies the offset X (horizontal) value of the arc's 
center point in GIDIS output space. 


Specifies the offset Y (vertical) value of the arc's 
center point in GIDIS output space. 


The angle is given in degrees, with a positive value 
meaning clockwise with respect to the physical screen. 


SUCCESS, provided angle within a range of -360 to +360 
and there is no filled figure table overflow or 
arithmetic overflow, otherwise FAILURE. 


Please refer to the notes for DRAW ARC. 


Example: 


BYTE 
»WORD 
»WORD 
-WORD 


DRAW REL ARC 


;Current position is [400,300] 
*;Filled figure flag is FALSE 

3.,27. ;Length=3,opcode is DRAW REL ARC 

-100. Center is [-100,+30] 

+30. ; relative to current position 

-90. 7;90 degrees = one quadrant (clockwise) 
;DrawS one quadrant from [400,300] to 
> [330,430] centered at [300,330] 
;New current position is [330,430] 


CHAPTER 7 


FILLED FIGURE INSTRUCTIONS 


This chapter contains a detailed description of each filled 


figure instruction. Table 7-1 lists the instructions covered in 
the chapter. 


Table 7-1: Filled Figure Summary Chart 
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Opcode/Length Instruction/Arguments 
31/0 BEGIN FILLED FIGURE 
32/0 END FILLED FIGURE 
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7.1 BEGIN FILLED FIGURE 


This instruction starts the definition of a closed figure to be 
filled by the END FILLED FIGURE instruction. Filling a figure 
occurs according to the current attributes in effect. A 


corresponding END FILLED FIGURE instruction iS required to 
actually fill the figure. 


Opcode: 31 Length: 0 


Format: BEGIN FILLED FIGURE 


Status: SUCCESS 


The following PRO/GIDIS instructions are invalid (set status to 
failure and do nothing) when used between a BEGIN FILLED FIGURE 
instruction and its corresponding END FILLED _ FIGURE. 


BEGIN FILLED FIGURE 
DRAW CHARACTERS 
SET GIDIS OUTPUT _SPACE 


BEGIN FILLED FIGURE 


SET OUTPUT IDS 

SET OUTPUT VIEWPORT 
SET POSITION 

SET REL POSITION 


Notes: 


@ The current position is saved in the filled-figure table as 
are the first and last point of the figure. 


e If a filled figure is in progress, this instruction is 
Piva lwad. 


@ BEGIN FILLED FIGURE sets the filled-figure flag to TRUE. 


e Use DRAW LINES, DRAW REL LINES, DRAW ARC, and DRAW REL ARC to 
enter positions in the filled-figure table. 


@ No drawing is done by the BEGIN FILLED FIGURE function. 


@® To abort a filled-figure definition, send the INITIALIZE 
instruction with any argument (including 0). An INITIALIZE 0 
instruction aborts a Filled-figure definition without 
affecting anything else. 


Example: (See END FILLED FIGURE.) 


Tez2 END FILLED FIGURE 
The: END: FILLED FIGURE instruction terminates the derinition of a 
closed figure and fills the figure. This instruction is used in 


conjunction with the BEGIN FILLED FIGURE instruction, described 
in the preceding paragraphs. 7 


Opcode: 32 Length: 0 
Format: END FILLED FIGURE 


Status: SUCCESS if there is a corresponding BEGIN FILLED FIGURE, 
otherwise, FAILURE. 


Notes: 


e The filled-figure table contains the vertices of the figure 
to be filled. 


END FILLED FIGURE 


The edges of the filled figure are the mathematically ideal 
lines through the positions in the filled-figure table, but 
one "extra" pixel is included to ensure that no gap occurs 
between two adjacent areas. The edge is not guaranteed to be 
identical to a line drawn (outside of a filled-figure 
definition) through the same points due to differences in 
drawing direction and round-off errors. 


The current position is unchanged by the END FILLED FIGURE. 
Current position is left at the last position given. Note 
that if table overflow occurred, the last point might not be 
the last vertex in the filled-figure table. 


This instruction modifies the bitmap inside the clipping 
region. 


If too many positions are specified, only the first 256 
vertices are used, and a straight line connects the 256th 
point with the first point. (256 is the maximum number of 
vertices in the filled-figure table for P/OS 1.7.) 


Global attributes used in the fill are: primary writing 
color, secondary writing color, writing mode, plane mask, 
area texture cell, area cell size, and area size. Unused 


global attributes are: pixel size. 


Complement and complement-negate writing modes can _ give 
unexpected results when filled figure areas overlap or abut. 


Example: 


~-BYTE 
~WORD 
«WORD 
~-BYTE 


~-BYTE 
»WORD 
~WORD 
eWORD 
-WORD 


BX TE 
«WORD 
-WORD 
«WORD 


~-BYTE 


22,29. 
100. 
100. 
Os g3 44 


4.,26. 
+100. 
+0. 
+0. 
+100. 


2D 0% 720% 


100. 
200. 
=32/68.. 


roe ae 


END FILLED FIGURE 


;Length=2,opcode for 
Current position 

>; is [100,100] 
>Length=0,opcode for 
*-Filled-figure table 
>Length=4,opcode for 
Pax) 

dy) 

rpdx2Z 

;dy2 


SET POSITION 


BEGIN FILLED FIGURE 
now has [100,100] 
DRAW REL LINES © 


sAdds points [200,100] and [200,200] to 


* the filled-figure 


;END LIST terminated,opcode = 
«xl 
7x2 
*END LIST 


table 
DRAW LINES 


sAdds point [100,200] to 


; the filled-figure 


table 


;Length=0,opcode for END FILLED FIGURE 
>The area defined by [100,100], 


; [200,100], 
[100,100] 


~~ =e wo =e 


in effect.) 


[200,200], 
(a Square) 
the current area texture (modified by 
whatever current global attributes are 


[100,200], and 
is filled with 


CHAPTER 8 


TEXT INSTRUCTIONS 


This chapter contains a detailed description of each text 
instruction. Table 8-1 lists the instructions covered in the 
chapter. 

Table 8-1: Text Instructions Summary Chart 

Opcode/Length Instruction/Arguments = | 
38/1 SET ALPHABET alphabet~-number 

46/4 CREATE ALPHABET width, height, extent, width-type 
34/n LOAD CHARACTER CELL , char-index, width, dO, dl,...,dn 
43/1 SET CELL RENDITION cell-rendition 

44/1 SET CELL ROTATION dxy, ‘dy 

65/1 SET CELL OBLIQUE dx, dy 

45/2 SET CELL UNIT SIZE width, height 

40/2 SET CELL DISPLAY SIZE width, height 

a2 7a SET CELL MOVEMENT MODE flag 

41/2 SET CELL EXPLICIT MOVEMENT dx, dy 

35/n DRAW CHARACTERS char-indexl, char-index2, ... 


SET ALPHABET 


8.1 SET ALPHABET 


The SET ALPHABET instruction selects a specific alphabet to be 
used as the current alphabet. Any alphabet-related operations, 
except as noted, act on the currently selected alphabet. 


Opcode: 38 Length: l 
Format: SET ALPHABET alphabet 


alphabet is an integer value in a range of O to 15 that 
specifies the current alphabet. 


Status: SUCCESS if the alphabet number is valid (from 0 to 15), 
FAILURE otherwise. 


Notes: 


@® Valid alphabet numbers for the Professional (P/OS 1.7) are 0 
through 15. Alphabet 0O is the DEC Multinational Character 


Set. 


@ Alphabet 0, the DEC Multinational font, 1S a read-only 
alphabet and cannot’ be changed through PRO/GIDIS. Control 
characters (indices 0 through 31 and 128 through 159 decimal) 
are not included, and, if requested with DRAW CHARACTERS, 


appear as an error ("blob" or "checkerboard") character. 
Some indices are resevered and appear as a reversed question 
mark. 


@e The current alphabet can be reset to the power-on default (0) 
by the PRO/GIDIS INITIALIZE instruction's text subsystem 
option. 


@ No drawing is done by the SET ALPHABET instruction. 
Examples: 


eBYTE ego ;Length=l1, opcode for SET ALPHABET 
«WORD 2s ;Selects alphabet #2 as current alphabet 


8.2 CREATE ALPHABET 


CREATE ALPHABET erases the current alphabet and reserves 
resources for an alphabet with the specified storage size (width 
by height by extent). 


CREATE ALPHABET 


Opcode: 46 Length: 4 


Format: CREATE ALPHABET width, height, extent, width-type 


width is an integer in the range (0 to 16) that specifies 
the number of horizontal bits in a character pattern. 


height is an integer in the range (0 to 16) that specifies 
the number of vertical bits in a character pattern. 


extent is an unsigned integer that specifies the number of 


characters in the alphabet. Character indices can 
range from 0 to extent - l. 


width-type is reserved for future use. For the Professional, 


this value must be 0. 


Status: SUCCESS if width and height are greater than or equal to 


zero, the width type is zero, the current alphabet number 
is a valid user definable alphabet (not 0), and there are 


sufficient resources to create the alphabet; FAILURE 
otherwise. 


Notes: 
® Character indices are 16-bit numbers and do not necessarily 
correspond to DEC Multinational codes (except for alphabet 
0). 
e For the Professional, all characters in an alphabet have’ the 
Same storage size. 
® To reclaim alphabet space, CREATE ALPHABET 0,0,0,0 erases the 
existing alphabet and returns all of the alphabet'‘’s 
resources. 
Example: 


sCurrent alphabet is alphabet number 2 
sBYTE 4.,46. ;:Length=4, opcode for CREATE ALPHABET 


«WORD 10. width 
.WORD 16. sheight 
»WORD 32.4 -extent 
»WORD 0. ewidth-type (Note: MUST BE ZERO) 


*Erases alphabet 2 and 
* creates an empty alphabet with 
> the specified characteristics 


LOAD CHARACTER CELL 


8.3 LOAD CHARACTER CELL 


The LOAD CHARACTER CELL instruction loads a character cell from 
the raster data given as parameters. This instruction acts on 
the currently selected alphabet. 


Opcode: 34 Length: variable 
Format: LOAD CHARACTER CELL char-index, width, dO, dl,...,dn 


char-index The index of the character cell to be loaded. This 
value must be ina range of 0 to extent - 1, where 
extent 1s the total character count for the alphabet. 
‘Dsl l2s width The width value must be ina 
range of 0O to the width value given with the 
CREATE ALPHABET instruction that established the 
alphabet. (P/OS 1.7 does not use _ this value. 
However, it still must be in the appropriate range.) 


dO, dl,... Zero to 16 words of data to be loaded into the 
character cell. The top character cell row is loaded 
from the first data word (dO), the second row from 
the second data word (dl), and so forth. 


Status: SUCCESS if character index 1S in a range of OO to 
extent - 1, and width is in a range of 0 to alphabet 
width; otherwise, FAILURE. 


Notes: 


e The leftmost pixel in a row comes from the low-order bit in 
the appropriate data word. 


@ Characters cannot be loaded into any alphabet with an extent 
value of zero. 


Example: 


Alphabet 2 has width of 4, height of 5, 
> and extent of 10 
BYTE 6.,46. ;Length=6, opcode for LOAD CHARACTER CELL 


WORD 9. sCharacter index (last cell in alphabet) 
WORD 4. -Width 

»WORD “B1011 ;Pattern: ON ON OFF ON 

-WORD ~B1010 OFF ON OFF ON 

«WORD ~“B1000 (Note the OFF OFF OFF ON 


WORD “BOOO1 bit reversal) ON OFF OFF OFF 
OFF OFF OFF OFF 


Last row not given,cleared automatically 


=e ~o ~e =O WO 


SET CELL RENDITION 


8.4 SET CELL RENDITION 


The SET CELL RENDITION instruction specifies the renditions to be 
added to characters written following execution of this 
instruction. Renditions are variations on characters that could 
be performed without selecting a new alphabet, yet are not 
related to writing colors or writing modes. Renditions defined 
for the Professional are: backslant and italics. 


Opcode: 43 Length: 1 
Format: SET CELL RENDITION mask-value 


mask-value A mask representing one or more of the cell 


renditions. The mask value corresponds to one or 
more rendition bits set. (See Figure 8-1). 


Status: SUCCESS if the requested rendition iS supported by the 
implementation, FAILURE otherwise. 


This instruction specifies a bit-mask value indicating which 
renditions are to be added. Certain mask bits are reserved for 
future PRO/GIDIS enhancements. Figure 8-l illustrates the 
defined rendition bits that can be selected. 


Lo: 24 13-d2 2110 9 8 F © & 42 3 2 2 BD 
$a-4--4+--4+--4--4--4+--4--4t--4t--t--4t--4+--4+-- $--t--F 
a ce ee cee ee a Ge a a 
$—-4+-—4$--4+--4-- b--$--4--t--4--4--t--4--4--t--4t--4+ 
| -- Back Slant 
| -- Italics 
ro} ft tot tot to to t tot tt > (Reserved) 


Figure 8-l: SET CELL RENDITION Bit Mask 


Notes: 


@e Setting both backslant and italics (mask value ~BOOO11) is an 
error. In this case, rendition is undefined. 


@e Italics and backslant (reverse italics) are generated by 
oblique angles of -23 and +23 degrees, respectively. 
Requesting italic or backslant rendition overrides any 
specific oblique angle requested previously. Requesting an 
oblique angle after an italic rendition request nullifies the 
italic request. 


Example: 


BYTE Lega ;Length=l1, opcode for SET CELL RENDITION 
- WORD 2% ;Requests italics rendition 
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SET CELL ROTATION 


8.5 SET CELL ROTATION 


The SET CELL ROTATION instruction defines the angle of rotation 
at which the character is to be displayed. The character is 
rotated about the current position (upper left corner of the 
display cell) to the available rotation angle nearest to the 
angle specified. Table 8-2 shows the angles available. 


Opcode: 44 Length: 1 
Format: SET CELL ROTATION angle 


angle The requested angle in degrees. A positive angle value 
indicates counter-clockwise from normal text. 


Status: SUCCESS 


Notes: 


@ No drawing takes place when the SET CELL ROTATION instruction 
executes. 


Examples: 


sBYTE 1.,44. ;Length=1, opcode for SET CELL ROTATION 


»WORD =U) *Text to go down the screen 
Requested Actual 
0 0 
45 Soi 
90 90 
130 E29 
180 180 
225 232 
270 270 
315 309 


Table 8-2: Cell Rotation Angles 
8.6 SET CELL OBLIQUE 


An obliqued character cell is slanted away from a true 
rectanglular orientation. The SET CELL OBLIQUE instruction 
specifies the angle from vertical of the side of the display 
cell. A positive angle parameter results ina back-slanted 
character; a negative angle yields a forward, italic-type slant. 
Oblique angles always are set for unrotated characters. The 
oblique angle rotates with the specified rotation. 


SET CELL OBLIQUE 


Opcode: 65 Lengths l 


Format: SET CELL OBLIQUE angle 


angle The requested angle in degrees. A positive angle value 


indicates a backward slant; a negative angle indicates a 
forward slant. 


Status: SUCCESS 
Notes: 
@ No drawing takes place when SET CELL OBLIQUE executes. 


@® PRO/GIDIS (P/OS V1.7) uses an approximation algorithm to 
Oblique text which is accurate for small angles (less than 
ten degrees), less accurate for medium angles (up to 25 
degrees), and inaccurate for large angles. Increasing the 
argument value will always increase the text oblique. 


Example: 


eBYTE ul 62320 ve ;Length=1, opcode for SET CELL OBLIQUE 
«WORD -23. *Regular italics (slanting right) 


8.7 SET CELL UNIT SIZE 


The SET CELL UNIT SIZE instruction specifies the actual size of 
character(s) displayed; the size is specified in GIDIS output 


Space. The stored character pattern is mapped completely to the 
unit size. 


Opcode: 45 Length: 2 
Format: SET CELL UNIT SIZE width, height 


width A width value in GIDIS output space. The width must _ be 
greater than zero. 


height A height value in GIDIS output space. The height must be 
greater than zero. 


Status: SUCCESS if width and height are greater than zero, 
FAILURE otherwise 


For PRO/GIDIS, the unit size is restricted to an integral 
multiple of the character pattern (storage size). PRO/GIDIS uses 
the largest available size that is not larger than the s1ze 
specified. If no available size is small enough, the smallest 


OT 


SET CELL UNIT SIZE 


available is used. Refer to the SET CELL DISPLAY SIZE to define 


the size of the area in which the cell unit is displayed. 
Notes: 

e The requested unit size does not change when the current 
alphabet changes, but the adjustment described above is 
recalculated. 

@ The unit cell and the display cell always are aligned at 
their upper-left corners. 

@ No drawing is done when the SET CELL UNIT SIZE executes. 

Example: 
BYTE 1.,45. ;Length=1l, opcode for SET CELL UNIT SIZE 
«WORD 10. ;Width 
.WORD 30. sHeight 

8.8 SET CELL DISPLAY SIZE 


SET CELL DISPLAY SIZE defines a character's display cell, the 
rectangular area of the display modified when a character is 


drawn. 


Opcode: 40 Length: 2 


Format: SET CELL DISPLAY SIZE width, height 


width A width value in GIDIS output space. 


height A height value in GIDIS output space. 


Status: SUCCESS 


Notes: 


The origin of the display cell is always the upper left 
corner of the cell and is aligned with the unit cell at that 
corner. 


The unit cell can be larger than the display cell; if so, the 
character is clipped to the display cell. If the unit cell 
is smaller than the display cell, then all of the character 
1s drawn and the rest of the display cell is treated as if 
the character pattern specified OFF. 


SET CELL DISPLAY SIZE 


@ Negative values in width or height produce a mirroring in xX 
and Y, respectively. This mirroring or reflection always is 
done about the origin (the upper-left corner of the cell). 
Implied movement always goes across the display cell, so 
implied movement for a display cell mirrored in X is in the 
opposite direction from the rotation angle. 

@ No drawing is done when the SET CELL DISPLAY SIZE executes. 

e If either the width or the height is zero, no portion of a 
character is drawn. 

Examples: 
«BYTE 2.,40. ;Length=2, opcode=SET CELL DISPLAY SIZE 
eWORD ea ;Width 
«WORD 23. ;Height 

8.9 SET CELL MOVEMENT MODE 


The SET CELL MOVEMENT MODE instruction specifies the manner in 


which the current position moves after each character is drawn by 
a DRAW CHARACTERS instruction. 


Opcode: 42 Length: 1 


Format: SET CELL MOVEMENT MODE flag 


flag specifies one of the following movement modes: 


0 Explicit cell movement, local symmetry 
2 Explicit and implied movement, local symmetry 


(All other values are reserved.) 


Status: SUCCESS if Flag is 0 or 2, FAILURE otherwise. 


Notes: 


When using local symmetry, the current position after a 
DRAW CHARACTERS instruction could be different from that 
calculated by your program. It is suggested that all 
DRAW CHARACTERS instructions be followed with a SET POSITION 
instruction or a REQUEST POSITION instruction unless’ the 


exact end of the string is the desired position for the next 
INStYrUCTION:. 


SET CELL MOVEMENT MODE 


@ No drawing occurs when the SET CELL MOVEMENT MODE instruction 
executes. 


e If the flag specified is not 0 or 2, the flag does not change 
from its previous state. 


Example: 


~BYTE 1.,42. ;Length=1, opcode=SET CELL MOVEMENT MODE 
«WORD 0. ;Explicit local mode symmetry 


8.10 SET CELL EXPLICIT MOVEMENT 


The SET CELL EXPLICIT MOVEMENT instruction specifies the relative 
distance that the current position is to move after a character 
is drawn. The relative distance is specified in GIDIS output 
Space. 


Opcode: 41 Lengths: 2 
Format: SET CELL EXPLICIT MOVEMENT Gx; dy 


dx Specifies the horizontal distance in GIDIS output space 
to move the current position. 


dy Specifies the vertical distance in GIDIS output space to 
move the current position. 


Status: SUCCESS 


The explicit value is the total movement when the cell movement 
mode is 0. The value represents the inter-character spacing when 
the mode is 2. (Refer to the preceding SET CELL MOVEMENT MODE 
description for details on implied movement.) The default mode is 
2, Gefault explicit movement is [0,0]. 


Notes: 


® No drawing occurs when the SET CELL EXPLICIT MOVEMENT 
instruction executes. 


@ When uSing local symmetry, the current position after a 
DRAW CHARACTERS instruction could be different from that 
calculated by your program. It 1S suggested that all 
DRAW CHARACTERS instructions be followed with a SET POSITION 
instruction or a REQUEST POSITION instruction unless’ the 
exact end of the string is the desired position for the next 
Instruction. 


SET CELL EXPLICIT MOVEMENT 


@e The explicit movement is used exactly as specified. lt -1s 
not adjusted according to the rotation angle. 


Example: 


sBLTE 2.,41. ;Length=2,SET CELL EXPLICIT MOVEMENT 


»~WORD Is °dx 
»WORD on Pay 
8.11 DRAW CHARACTERS aes 


The DRAW CHARACTERS instruction displays each of the characters 
specified by each character index in the parameter list. The 
characters are taken from the currently selected alphabet. 


Opcode: 35 Length: n 


Format: DRAW CHARACTERS  char-index, 


char-index an unsigned 16-bit word 


Status: SUCCESS if the current alphabet number is valid and if 


the last character-index is valid in the alphabet, 
FAILURE otherwise. 


Characters can be specified either in a counted argument list 
(with the count supplied with the opcode word) or in an END LIST 
terminated list with 255 in the opcode word. The rules’ for 


variable-length argument lists for PRO/GIDIS are described in 
Chapter 2 of this manual. 


Notes: 


® The current position is updated after each character display, 
according to the cell movement controls. (See the 
descriptions of the SET CELL MOVEMENT MODE and 
SET CELL EXPLICIT MOVEMENT instructions.) 


® This instruction uses implied and explicit cell movement, 


unit and display size, cell rotation, rendition mask, current 
alphabet, and writing mode. 


@ DRAW CHARACTERS modifies the bitmap (only inside the clipping 
region) and the current position. 


Example: 


Example: 


-BYTE 


«WORD 
eWORD 
~WORD 


~-BYTE 
~WORD 
-WORD 
»WORD 
-WORD 
-WORD 


S739 % 


65. 
66. 
67. 


DRAW CHARACTERS 


;Current alphabet = 0 (DEC Multinational) 
;Unit size, display size, etc. are | 
; set up properly 

;Length=3, opcode for DRAW CHARACTERS 
;Counted form 

a ae 

'B! 

LC. 


=e we WO 


;Current alphabet = 1 (user-defined) 
;Unit size, display size, etc. are 

; set up properly 

;END LIST Term.,opcode = DRAW CHARACTERS 


;END LIST 
;Displays 4 characters from alphabet l, 
* which are user-defined characters 


CHAPTER 9 


AREA OPERATION INSTRUCTIONS 


This chapter contains a detailed description of each of the area 
operation instructions. Table 9-1 lists the instructions covered 
in the chapter. 


Table 9-l: Area Operations Summary Chart 


48/0 ERASE CLIPPING REGION 


141/6 PRINT SCREEN x, y, width, height, hx, hy 
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9.1 ERASE CLIPPING REGION 


The ERASE CLIPPING REGION instruction sets every pixel inside the 
current output clipping region to the secondary color that is 
currently in effect. This instruction erases data currently 
displayed within the region. ERASE CLIPPING REGION can be used 
to clear a rectangular area without implying the end of a picture 
or the beginning of a new picture. 


Opcode: 48 Length: 0 
Format: ERASE CLIPPING REGION 


Status: SUCCESS 


ERASE CLIPPING REGION 


Notes: 


@® To erase the entire screen, use the END PICTURE/NEW PICTURE 
combination, not the ERASE CLIPPING REGION. 


e This instruction sets the bitmap in the output clipping 
region. 


@e The current writing mode, current area texture, and primary 
color do not affect this instruction. 


Example: 


-BYTE 0.,48. ;Length=0, opcode=ERASE CLIPPING REGION 


9.2 PRINT SCREEN 


The PRINT SCREEN instruction Sends a speciiiled portion of the 
bitmap to a printer connected to the printer port, generally an 
LA50 or LAI1OO. Parameters permit you to indicate the portion of 
the data to be printed and the relative point on the paper for 
the printer to start printing. 


Opcode: 141 Length: 6 
Format: PRINT SCREEN x, y, width, height, hx, hy 


x Specifies the upper left horizontal point of the bitmap 
data to be printed. This location is given in GIDIS 
output units. 


y Specifies the upper left vertical point of the bitmap 
data to be printed. This location is given in GIDIS 
output units. 


width Width of the area to be printed, specified in GIDIS 
output units 


height Height of the area to be printed, specified in GIDIS 
output units 


hx Specifies the horizontal offset from the current 
printhead location to begin printing the screen data. 
This point corresponds to the upper left horizontal 
coordinate (x) of the data to be printed. The value is 
given in GIDIS Output Space coordinates. 


hy Specifies the vertical offset from the current printhead 
location to begin printing the screen data. This point 


=z 


PRINT SCREEN 


corresponds to the upper left vertical coordinate (y) of 
the data to be printed. The value is given in GOS 
coordinates. 


Status: SUCCESS 


Notes: 


In a Single plane system, a pixel value of 0 is mapped to a 
skip (leaves paper white) and a 1 is mapped to a strike 
(prints on the paper). On multi-plane systems, the 
monochrome value of the color map is tested. If 0, the point 
is skipped (white), if not zero, the point prints. 


e If the printer port does not have an LA5O or LAI1LOO connected, 
nothing occurs. 
Example: 


sBYTE 6.,141. ;Length=6, opcode for PRINT SCREEN 


«WORD 100. ;Upper left bitmap corner 

«WORD 100». ; is [100,100] 

«WORD 400. 7;Data to be printed is 400 units wide 
«WORD 200. ; by 200 units high 

«WORD 0. ;Begin printing at current printhead 
«WORD O's ; location 


CHAPTER 10 


REPORT HANDLING 


This chapter contains a detailed description of each of the 
report handling instructions. Table 10-1 lists the instructions 
and report tags covered in the chapter. 


Table 10-1: Report Handling Summary Chart 
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55/0 REQUEST CURRENT POSITION CURRENT POSITION REPORT x, y 


58/0 REQUEST STATUS STATUS REPORT code 


54/0 REQUEST CELL STANDARD CELL STANDARD REPORT uw, uh, dw, dh 
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10.1 REQUEST CURRENT POSITION 


The REQUEST CURRENT POSITION instruction reports the absolute 
location of the current position. The current position is the 


display location at which the next character, line, or arc would 
be drawn. 

Opcode: 55 Length: 0 

Format: REQUEST CURRENT POSITION 

Status: SUCCESS 


The reported information takes the following form: 


CURRENT POSITION REPORT, x, y 
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REQUEST CURRENT POSITION 


The X and Y values reported are the PRO/GIDIS output’ space 
coordinates of the current position. 


Notes: 


@® The current position is not necessarily the same as the last 
position given to SET POSITION or DRAW LINES; DRAW CHARACTERS 
and DRAW ARC instructions also move the current position. 


@® The REQUEST CURRENT POSITION instruction is most useful 
following a DRAW ARC or a DRAW CHARACTERS (local symmetry), 
Since your program cannot determine precisely where PRO/GIDIS 
leaves the current position after these instructions. 


Example: 


-BYTE 0.,55. ;Lgth=0, opcode=REQUEST CURRENT POSITION 

This instruction causes the following 
report to be placed in the report 
queue if there is sufficient room. 


Byte 2. (Data words following) 
Byte 1. (Current Pos. Rpt. Tag) 
Word x (PRO/GIDIS coordinates 
Word y for current position) 


=e RO WH WE WH WE WH WEE WHE WE BWH ASG 


The report can be read using a QIO 
> with the function code IO.RSD. Refer 
> to Chapter 2 for more information. 


10.2 REQUEST STATUS 


REQUEST STATUS reports the success or failure of a PRO/GIDIS 
instruction. All PRO/GIDIS instructions set the status variable. 


Opcode: 58 Length: 0 

Format: REQUEST STATUS 

Status: SUCCESS 

Status is reported in the following format: 
STATUS REPORT, status 


where the low-order bit of the variable status is either 1 
indicating SUCCESS or 0 indicating FAILURE. 


LO=2 


REQUEST STATUS 


Notes: 


@ No other codes are defined. (Codes other than OO or 1 


are 
reserved for future uSe.) 

@ FAILURE status is not’ saved. If your program needs 
information about the success or failure of every 


instruction, you must place a REQUEST STATUS instruction 


after each PRO/GIDIS instruction. 


® Testing is recommended only following major PRO/GIDIS 


instructions, such as CREATE ALPHABET. 


Example: 


;assumes previous instruction failed 
sBYTE Oras coer ;Lgth=0, opcode=REQUEST STATUS 


Byte 1. (Data words following) 
Byte 4. (Current Stat. Rpt. Tag) 
Word OQ (FAILURE status) 

;For additional examples, refer to 
;Chapter 2. 


we we 36 We 


10.3 REQUEST CELL STANDARD 


The REQUEST CELL STANDARD instruction reports the current 
cell and display cell sizes. 


Opcode: 54 Length: 0 

Format: REQUEST CELL STANDARD 
Status: SUCCESS 

The report takes the following form: 


CELL STANDARD REPORT, unit-wd, unit-ht, 
display-wd, display-ht 


where unit-wd and unit-ht are the unit cell width and height 


unit 


of 


the standard size character in GIDIS space. Display-wd and 


display-ht are the display cell width and height. 
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REQUEST CELL STANDARD 


Notes: 


This instruction takes into account the storage size of the 
current alphabet and the character rotation currently in 
effect. The standard size for alphabet 0 (DEC Multinational) 


is not necessarily the same as the standard size for alphabet 
I 


@ Rounding could take place converting from device coordinates 
to GIDIS space. If your program requests ‘n' times the size 
of the standard, the characters actually formed might not be 
precisely 'n' times the standard. 

Example: 


BYTE U.2454- ;Lgth=0, opcode=REQUEST CELL STANDARD 


; Byte 4. (Data words following) 

>; Byte 95. (Cell Standard Rpt. Tag) 
; Word 9. (Unit width) 

> Word 20. (Unit height) 

; Word 8. (Display width) 

*- Word 20. (Display height) 


;For additional examples, refer to 
;Chapter 2. 
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This chapter contains a PRO/GIDIS instruction 
different orders: 
alphabetic order. 


APPENDIX A 


PRO/GIDIS INSTRUCTION SUMMARIES 


by Lunctron, 


summary 


in ascending opcode order, 
The opcode and parameter block 
are shown as a word value as well as separate byte values. 


length 


in three 
and in 
values 
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SET AREA TEXTURE SIZE w, 
SET AREA TEXTURE a, c 
SET SECONDARY COLOR color 

SET COLOR MAP ENTRY m, color, r, g, b, 
SET LINE TEXTURE length, pattern, size 


OX, 


SET PRIMARY COLOR color 
SET WRITING MODE mode 


A.1 INSTRUCTIONS GROUPED BY FUNCTION 
Opcode 

Length 

Opcode Word 

Or. <0; 16 NOP 

L & 257 INITIALIZE mask 

5 6 1286 SET OUTPUT CURSOR a, 

6 0O 1536 NEW PICTURE - 

24 0 6144 END PICTURE - 

28 O 7168 FLUSH BUFFER - 
128 0 -32768 END LIST - 

4 4 1028 

9 4 2308 z z 

12 2 3074 SET OUTPUT IDS w, h 

13 4 3332 

s > 770 

14 2 3586 

15 1 3841 

16 6 4102 

17 3 4355 

19 4 4868 GET PIXEL SIZE w, h, 

20 1 5121 SET PLANE MASK mask 

21 1 5377 

22 1 5633 

69 2 17666 


SET AREA CELL SIZE w, h 


A-1l 


Cr 


Wy 


SET OUTPUT VIEWPORT x, y, w, h 


h 


oy 


SET OUTPUT CLIPPING REGION x, y, w, h 
SET GIDIS OUTPUT SPACE x, y, w, h 


control 
control 
control 
control 
control 
control 
control 


transform 
transform 
transform 
transform 


attributes 
attributes 
attributes 
mono . 

attributes 
attributes 
attributes 
attributes 
attributes 
attributes 


INSTRUCTIONS GROUPED BY FUNCTION 


DRAW ARC x, y, angle 

DRAW LINES x, yy «-- 

DRAW REL LINES dx, dy, ... 
DRAW REL ARC dx, dy, angle 
SET POSITION x, y 

SET REL POSITION dx, dy 


BEGIN FILLED FIGURE - 
END FILLED FIGURE - 


BEGIN DEFINE CHARACTER c, w 

LOAD CHARACTER CELL c, w, dO, ... dl15 
DRAW CHARACTERS c, ..- 

END DEFINE CHARACTER - 

SET ALPHABET a 

SET CELL DISPLAY SIZE w, h 

SET CELL EXPLICIT MOVEMENT dx, dy 
SET CELL MOVEMENT MODE flag 

SET CELL RENDITION flags 

SET CELL ROTATION angle 

SET CELL UNIT SIZE w, h 

CREATE ALPHABET w, h, extent, type 
SET CELL OBLIQUE angle 


ERASE CLIPPING REGION - 
PRINT _ SCREEN Xy Ver We Hy. Nks AY 


REQUEST CELL STANDARD - 
REQUEST | ~ CURRENT _POSLTION = 
REQUEST _ STATUS - 


INSTRUCTIONS IN OPCODE ORDER 


drawing 
drawing 
drawing 
drawing 
drawing 
drawing 


filled figures 
filled figures 


text 
text 
text 
text 
text 
text 
text 
text 
text 
text 
text 
text 
text 


area 
area 


reports 
reports 
reports 
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23 3 5891 
25 N 6400+N 
26 N 6656+N 
27 3 6915 
29 2 7426 
30° 2 7682 
31 0 7936 
32 OQ 8192 
33. 2 8450 
34 N 8704+N 
35 N 8960+N 
36: 0 “9216 
38 -t 9729 
40 2 10242 
41 2 10498 
AZ lL. LO7S3 
43 1 11009 
44 1 11265 
45 2 11522 
46 4 11780 
65 1 16641 
48 QO 12288 
141 6 -29434 
54 Q 13824 
55 OQ 14080 
58 QO 14848 
A.2 
Opcode 
Length 
Opcode Word 
0 dO QO 
tL oa 2S7 
3 2. TIO 
4 4 1028 
5 6 1286 
6 O 1536 
9 4 2308 
12 2 3074 
13 4 3332 
14 2 3586 
15 1 3841 


NOP - 

INITIALIZE mask 

SET AREA TEXTURE SIZE w, h 

SET OUTPUT _CLIPPING _REGION x, y, w, h 
SET OUTPUT CURSOR a, c, w, h, OX, oy 
NEW PICTURE - 

SET GIDIS OUTPUT _SPACE x, y, w, hh 

oy aa _ OUTPUT IDS w, h 

SET OUTPUT VIEWPORT X, VY, WwW, h 

SET AREA TEXTURE a, C 

SET SECONDARY COLOR color 


A-2 


control 
Contre: 
attributes 
transform 
Control 
control 
transform 
transform 
transform 
attributes 
attributes 


INSTRUCTIONS IN OPCODE ORDER 


16 6 4102 SET COLOR MAP ENTRY m, color, r, g, b, mono “ 
17 3 4355 SET LINE TEXTURE length, pattern, size attributes 
19 4 4868 SET PIXEL SIZE w, h, ox, oy attributes 
20 1 5121 SET PLANE MASK mask attributes 
Zi ‘lL 85377 SET PRIMARY COLOR color attributes 
22. + 5633 SET WRITING _MODE mode attributes 
23 3 £5891 DRAW ARC x, aay angle drawing 
24 0 6144 END PICTURE - control 
25 N 6400+N DRAW LINES x, yy, «e- drawing 
26 N 6656+N DRAW REL LINES dx, dy, ... drawing 
27 3: “6915 DRAW _ REL ARC dx, dy, angle drawing 
28 OO 7168 FLUSH BUFFER - control 
29. 2 7426 SET POSITION x, y drawing 
30 2 7682 SET REL POSITION dx, dy drawing 
31 OO 7936 BEGIN FILLED FIGURE - filled figures 
32 O 8192 END FILLED FIGURE - filled figures 
33 2 8450 BEGIN DEFINE CHARACTER c, w text 
34 N 8704+N LOAD CHARACTER CELL c, w, dO, ... d15 text 
35 N 8960+N DRAW CHARACTERS c, ..- text 
36 0 9216 END DEFINE CHARACTER - text 
38 1 9729 SET ALPHABET a text 
40 2 10242 SET CELL DISPLAY SIZE w, h text 
41 2 10498 SET CELL EXPLICIT MOVEMENT dx, dy text 
A2 1 20753 SET CELL MOVEMENT MODE flag text 
43 1 11009 SET CELL RENDITION Elags text 
44 1 11265 DET CE UL ROTATION angle text 
45 2 11522 SET CELL UNIT SIZE w, h text 
46 4 11780 #CREATE ALPHABET w, h, extent, type text 
48 Q 12288 ERASE CLIPPING REGION - area 
54 0 13824 REQUEST | CELL STANDARD - reports 
55 O 14080 REQUEST | ~ CURRENT _POSITION - reports 
58 Q 14848 REQUEST STATUS - reports 
65 1 16641 SET CELL OBLIQUE angle text 
69 2 17666 SET AREA CELL SIZE w, h attributes 
128 0 -32768 END LIST - control 
141 6 -29434 PRINT SCREEN x, Y, WwW, h, hx, hy area 
A.3 INSTRUCTIONS IN ALPHABETIC ORDER 
Opcode Instruction and Arguments Function 
Length 
Opcode Word 
sist 
33 2 8450 BEGIN DEFINE CHARACTER c, WwW text 
31 O 7936 BEGIN FILLED FIGURE - filled figures 
46 4 11780 CREATE ALPHABET w, h, extent, type text 
23 3 5891 DRAW ARC x, y, angle drawing 


A-3 


MreNORrMNMF BP PN DEPWPOANEFP KF KFEMNNNHNHEF COODCOBArFODOOCOOCOOCOOCOZMZW ZZ 


8960+N 
6400+N 


INSTRUCTIONS IN ALPHABETIC ORDER 


DRAW CHARACTERS c, ..- 

DRAW LINES x, y, «-. 

DRAW REL ARC dx, dy, angle 

DRAW REL LINES dx, dy, ... 

END DEFINE CHARACTER - 

END FILLED FIGURE - 

END LIST - 

END PICTURE - 

ERASE CLIPPING REGION - 

FLUSH BUFFER -_ 

INITIALIZE mask 

LOAD CHARACTER CELL c, w, dO, ... 
NEW PICTURE - | 

NOP - 

PRINT SCREEN x, y, w, h, hx, hy 
REQUEST CELL STANDARD - 

REQUEST CURRENT POSITION - 
REQUEST STATUS = 

SET ALPHABET a 

SET AREA CELL SIZE w, h 

SET AREA TEXTURE a, c 

SET AREA TEXTURE SIZE w, h 

SET CELL DISPLAY SIZE w, h 

SET CELL EXPLICIT MOVEMENT dx, dy 
SET CELL MOVEMENT MODE flag 

SET CELL OBLIQUE angle 

SET CELL RENDITION flags 

SET CELL ROTATION angle 
SET CELL UNIT SIZE w, h 
SET COLOR MAP ENTRY m, 
SET GIDIS OUTPUT SPACE x, y, w, h 
SET LINE TEXTURE length, pattern, 
SET OUTPUT CLIPPING REGION x, y, w, h 
SET OUTPUT CURSOR a, c, WwW, hh, Ox, oy 
SET OUTPUT IDS w, h 

SET OUTPUT VIEWPORT x, y, w, h 

SET PIXEL SIZE w, h, ox, oy 

SET PLANE MASK mask 

SET POSITION x%7-¥ 

SET PRIMARY COLOR color 

SET REL POSITION dx, dy 

SET SECONDARY COLOR color 

SET WRITING MODE mode 
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size 


text 
drawing 
drawing 
drawing 
text 
filled figures 
control 
control 
area 
control 
control 
text 
control 
control 
area 
reports 
reports 


reports 


text 
attributes 
attributes 
attributes 
text 
text 
text 
text 
text 
text 
text 
mono 
transform 
attributes 
transform 
control 
transform 
transform 
attributes 
attributes 
drawing 
attributes 
drawing 
attributes 
attributes 
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A.4 REPORT TAGS 


LA SD SE ED TT ED ON OE ED ce DR eR) OD SS VED DED WEN) WORE OUD “OREN ID WEED END TD eID Me NLD SEN cm IED ND GEE ENE OED Dm en ED com ren) cna OUND SOND SD GOED GRE GE GEN eo a ea SUED GE GD GMD ene 


Opcode Report Tag Arguments 


Function 
Length 
Opcode Word 
1 2 258 CURRENT POSITION REPORT x, y report tags 
4 1 1025 STATUS REPORT code 
> 


= report tags 
4 1284 CELL STANDARD REPORT uw, uh, dw, dh report tags 
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DEC MULTINATIONAL CHARACTER SET 


DEC MULTINATIONAL CHARACTER SET 


DEC Multinational Character Set (CO and GL Codes) 
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DEC Multinational Character Set (C1 and GR Codes) 
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DEC Special Graphics Set Mapped into GL 


oso iioetunnd 


COLUMN 


BITS 
87 


36 


85 


ROW B4 83 B82 B! 


@) 
oO 
Oo 


(oe) 
oO 


eee ee te 


1 


EY 


; BE | 
| NOS SO aS? 
O 79} (BLANK)| 95 | ria{ 
LaF | 1 se} scan ii 4F | 


| GL CODES 
(DEC SPECIAL GRAPHICS) | 


me Sm GS 


KEY 


CHARACTER | Poe 


B-4 


APPENDIX C 


GLOSSARY 


The words in this glossary are used throughout this manual. 
These definitions are not absolute and might differ somewhat in 
other contexts. Where possible, the most common computer 
industry usage is the basis of the definition. 


ALPHABET 


An alphabet is a collection of characters. The component 


characters are numbered 0,1,...n-l, where n is the extent of the 
alphabet. 


ALPHABET ATTRIBUTE 


An attribute that applies to an entire alphabet. PRO/GIDIS 
Supports storage width and height as its only alphabet 
attributes. 


ANISOTROPIC 


Not isotropic. In an anisotropic coordinate space, one unit in 
the X direction 1S not equal to one unit in the Y direction. 


AREA TEXTURE 


A binary pattern used to shade areas. In PRO/GIDIS this is 
selected from a normal character alphabet. Area texture includes 
size parameters (specified independently) to determine the 
appearance of the pattern. 


ASPECT RATIO 


The ratio of the width of an object to its height. Objects whose 
aspect ratio are important in graphics include video displays, 
rectangular extents (picture aspect ratio), and addressing 
spaces. 


GLOSSARY 


ATTRIBUTE 


A particular property that applies to a display element (output 
primitive), such as character height, line texture, and so forth. 


BITMAP 


The rectangular array of pixels (picture elements) that is 
displayed on the Professional's video screen. Also known as 
raster or frame buffer. The Professional has a bitmap 960 pixels 
wide by 240 pixels high, and either one or three planes deep. 


CHARACTER 

A character is a two-dimensional pattern made up of two "colors" 
or pixel states. A character is an.element in an alphabet and is 
specified by an identifying tuple (alphabet number, character 
number). 

CHARACTER CELL 

(See display cell or unit cell.) 

CLIPPING 


The drawing of only those parts of display elements that lie 
inside a given extent (the clipping region). 


COLOR 

A “real color" is a particular shade of light described in terms 
of its red, green, blue, and monochrome components. The color 
map can contain up to eight different real colors at one time. 

A “logical color" is a value that represents an index into’ the 


color map. PRO/GIDIS draws images by storing either the primary 
or secondary logical color in pixels. 


COLOR MAP 

A table with entries that contain the values of the red, green 
and blue intensities of a particular color. This table is used 
to convert logical color to real color. 


CURRENT POSITION 


The position from which lines, arcs, and characters are to _ be 
drawn. 


GLOSSARY 


CURSOR 


A visual representation of the current position. 


DISPLAY CELL 


In text processing, the display cell is that area of the screen 
that a character should take up. The character pattern itself 
resides within a unit cell; any portion of the display cell not 
covered by the unit cell is treated as though the pattern is OFF 
for that area. If the unit cell is larger than the display cell, 
the unit cell is clipped at the display cell borders. 


DISPLAY ELEMENT 


A basic graphic element that can be used to construct a display 
image. (also Known aS a graphic primitive). The display 
elements for PRO/GIDIS are: lines, characters, filled figures, 
and arcs. 


FILLED FIGURE 


A GIDIS display element consisting of a polygon which is filled 
with a two-color pattern. 


GIDIS OUTPUT SPACE (GOS) 


An application-specified coordinate space used by all drawing and 
report operations in PRO/GIDIS. A location within the PRO/GIDIS 
Output space maps to a location within the viewport on _ the 
screen. 


GLOBAL SYMMETRY 


Preservation of GIDIS Output Space relationships at the expense 
of Hardware Address Space relationships. For example, suppose 
that a ten-unit distance in GOS maps to 7.5 units in HAS. With 
global symmetry, repeatedly moving ten GOS units results in a 
move of seven HAS units, then eight has units, then seven, and so 
FOrth. Local symmetry always would move seven HAS units each 
time. PRO/GIDIS, version 1.7, supports global symmetry for _ the 
SET REL POSITION, DRAW REL LINES, and DRAW REL ARC instructions. 


HARDWARE ADDRESS SPACE (HAS) 


A coordinate space (possibly anisotropic) used by the graphic 
hardware device. GIDIS hides this space from your program, and 
addresses the hardware through an Imposed Device Space or GIDIS 
Output Space. 


GLOSSARY 


IMPOSED DEVICE SPACE (IDS) 


A coordinate space imposed on the hardware by your program. An 
Imposed Device Space requests PRO/GIDIS to simulate the requested 
device in terms of aspect ratio and addressing’ space. IDS is 


used only to set the viewport. All other coordinates and sizes 
are in GIDIS Output Space. 


ISOTROPIC 


In an isotropic coordinate space one unit in the X direction is 
equal to one unit in the Y direction. 


LINE TEXTURE 


A linear pattern used to help distinguish lines. Examples are 
solid, dashed, dotted, and so forth. PRO/GIDIS supports a 
two-color (binary) up to 16 units in length. 


LOCAL SYMMETRY 


Preservation of Hardware Address Space relationships at the 
expense of GIDIS Output Space relationships. For example, assume 
a ten-unit distance in GIDIS output space maps to 7.5 units in 
hardware coordinate space. Local symmetry always would move 
seven hardware units each time. With global symmetry, repeatedly 
moving ten GIDIS output space units results in a move of seven 
hardware units, then eight hardware units, then seven, and_ so 
forth. PRO/GIDIS supports local symmetry for unit cells, display 
cells, and cell movement (implicit and explicit). 


ORIGIN 


The origin of an address space is the point [0,0]. In PRO/GIDIS, 
the origin of IDS space is always the upper left corner of the 
screen. The origin of GIDIS output space is set by your program. 


The origin of a character cell (either display cell or unit cell) 
is the point in the cell placed over the current position. This 
is also the point about which the cell rotates. For P/OS, V1.7, 
the character cell origin always is the upper left corner. 


OUTPUT SPACE 


(See GIDIS output space.) 


GLOSSARY 


PICTURE ASPECT RA 


TIO 


The ratio of the width of a picture to the height. This is 
normally expressed aS two small numbers, such as 4:3. The 
picture aspect ratio on the Professional 350 monitor is 8:5. In 


this context, "picture" means a rectangular extent in an address 
space. 


PIXEL (PICTURE ELEMENT) 


The smallest element of a display surface that can be assigned a 
color or intensity. 


PIXEL ASPECT RATIO 


The ratio of the width of a pixel to the height. The width is 
the horizontal distance between adjacent pixels and the height is 
the vertical distance. Pixel aspect ratio is normally expressed 
as two small numbers, e.g. 1:2. The pixel aspect ratio on the 
Professional. 350 monitor is 122.5 or 235% 


PLANE 


A plane is a portion of a bitmap that contains one bit for each 
pixel. The Professional 350 has either one plane (without EBO) 
or three planes (with EBO). 


PRIMARY COLOR 


The primary color is that logical color generally used to 
indicate the presence of an image. 


SECONDARY COLOR 


The secondary color is that logical color generally used to 
indicate the absence of an image. 


STANDARD DISPLAY SIZE 


The standard display size is normally equal to the standard unit 
size. However, for alphabet 0, rotation 0, the standard display 
size is slightly smaller (horizontally) than the standard unit 
size. This is for increased compatibility with the VT125. 


STANDARD UNIT SIZE 


The standard unit size depends on the alphabet width and height 
and the rotation angle. It is the size in GIDIS Output Space 
coordinates of the character displayed when one bit of the 
character pattern maps to exactly one pixel in the bitmap. 


GLOSSARY 


UNIT CELL 


In text processing, the unit cell is the area in which a 
character pattern is drawn. If the display cell is smaller that 
the unit cell, the unit cell is clipped at the display cell 
borders. If the unit cell is larger, the remainder of the 
display cell is treated as though the pattern is specified OFF 
for that area. PRO/GIDIS automatically shrinks the unit cell to 
the closest possible size and, if there is no size small enough, 
uses the smallest possible size. 


VIEWING TRANSFORMATION 

The process where user-specified coordinates (in GIDIS) output 
Space) are changed into hardware coordinates. This is also Known 
as the "graphics pipeline". 


VIEWPORT 


The viewport is an extent within Imposed Device Space. The 
viewing transformation maps the window to the viewport. 


WINDOW 


The window is an extent within GIDIS Output Space. The viewing 
transformation maps the window to the viewport. 


INDEX 


~A- BEGIN FILLED FIGURE 
aborted by initialization, 3-3 
Address space general description, 1-13 
in Viewing Transformation, 1-6 reference description, 7-1 
Alphabet Bitmap 
and REQUEST CELL _STANDARD, 10-3 and NEW PICTURE, 3-7 
creating, 1-25 definition, C-2 
definition, C-l description, 1-14 
description, 1-24 
reset state, 3-5 to 3-6 =C= 
user-defined, 1-24 
Alphabet attribute Cartesian Coordinate System 
Gefinition, C-l use of, 1-6 | 
Anisotropic Cell display size 
definition, C-l affected by 
Arc | SET GIDIS OUTPUT SPACE, 4-6 
drawinc, 6-7, 6-9 affected by SET OUTPUT _IDS, 4-3 
Area cell size description, 1-27 
setting, 5-12 reset state, 3-4 to 3-5 
Area operation Cell movement 
description, 1-29 affected by 
purpose, 1-5 SET GIDIS OUTPUT SPACE, 4-5 
Area texture affected by SET OUTPUT __ IDS, 4-3 
affected by description, 1-27 
SET GIDIS OUTPUT SPACE, 4-5 reset state, 3-4 to 3-5 
affected by SET OUTPUT IDS, 4-2 Cell oblique 
definition, C-l 7 description, 1-27 
description, 1-20 reset state, 3-5 
reset state, 3-4 to 3-5 Cell rendition 
setting, 5-10 description, 1-26 
taken from line texture, 5-10 reset state, 3-5 
Area texture cell size Cell rotation 
description, 1-21 description, 1-26 
Area texture size reset state, 3-5 
description, 1-20 Cell unit size 
setting, 5-ll affected by 
Aspect ratio SET GIDIS OUTPUT SPACE, 4-6 
definition, C-l affected by SET OUTPUT IDS, 4-3 
description, 1-7 description, 1-27 
Attribute reset state, 3-4 to 3-5 
definition, C-l CGL 


relationship to PRO/GIDIS, 1-2 
when to use, 1-3 


-B- Character 
definition, C-2 
Backslant _. Character cell 
see cell rendition definition, C-2 


Index-l 


INDEX 


Character rotation Current position (Cont.) 
and REQUEST CELL STANDARD, 10-3 definition, C-2 
Clipping description, 1-12 
definition, C-2 reporting, 1-30, 10-1 
Clipping region reset state, 3-4 
affected by setting, 6-1 to 6-2 
pit -GibIs OUTPUT SPACE, 4-5 Cursor 
affected by SET OUTPUT IDS, 4-2 affected by 
and window, 1-10 SET GIDIS OUTPUT SPACE, 4-5 
description, 1-9 affected by SET OUTPUT IDS, 4-2 
erasing, 9-1 definition, C-2. 7 
in viewing transformation, 1-7 purpose of, 1-12 
reset state, 3-4 reset state, 3-4, 3-6 
setting, 4-6 selecting built-in, 3-9 
Color setting, 3-8 
attributes, 1-14 Curve attribute 
detinit irony; -C=2 aescription, 1218 
Color map 
and complement mode, 1-17 -D- 
definition, C-2 
description, 1-15 DEC Multinational Character Set 
interaction with plane mask, as alphabet 0, 1-24 
5-6 Display cell 
reset state, 3-6 definition, C-3 
setting, 5-3 reporting, 10-3 
values, 5-4 Display element 
Complement mode definition, C-3 
description, 1-16 DRAW ARC | 
effect on filled figure, 1-21, and REQUEST CURRENT POSITION, 
7-3 10-2 — 
effect on line texture, 1-19 general description, 1-13 
effect on lines, 6-4 reference description, 6-7 
effect on pixel size, 5-8 DRAW CHARACTERS 
Complement negate mode and END LIST, 3-11 
description, 1-17 | and REQUEST CURRENT POSITION, 
effect on filled figure, 7-3 10-2 — 7 
effect on lines, 6-4 general description, 1-14 
Control instruction invalid in filled figure, 7-2 
purpose, 1-4 parameter block, 2-7 
CORE Graphics Library reference description, 8-1ll 
see CGL DRAW LINES 
CREATE ALPHABET and END LIST, 3-11 
in alphabet creation, 1-25 general description, 1-13 
reference description, 8-2 parameter block, 2-7 
Current pattern reference description, 6-3 
description, 1-15 DRAW REL ARC 
Current position general description, 1-13 
affected by reference description, 6-9 


SET GIDIS OUTPUT SPACE, 4-5 DRAW REL LINES 
arfected by SET OUTPUT IDS; 4>2 and END LIST, 3-11 
after DRAW ARC, 6-8 general description, 1-13 


Index-2 


DRAW REL LINES (Cont.) 
parameter block, 2-7 
reference description, 6-5 

Drawing instruction 
general description, 1-12 
purpose, 1-4 

SDSW variable 
values of, 2-4 to 2-5 


a ee 


EBO 
description, 1-15 
END FILLED FIGURE 
general description, 1-13 
reference description, 7-2 
END LIST 
and DRAW LINES, 6-3 
function of, 2-7 
general description, 1-6 
reference description, 3-11 
END PICTURE 
general description, 1-5 
reference description, 3-7 
use of, 3-6 
Erase mode 
description, 1-18 
Erase negate mode 
description, 1-18 
ERASE CLIPPING REGION 
general description, 1-29 
reference description, 9-1 
Error 
in instruction stream, 2-7 
Explicit movement 
description, 1-29 
Extended Bitmap Option 
see EBO 
Extent 
and picture aspect ratio, 1-8 
description, 1-7 


oo Ff om 


Filled figure 
and DRAW LINES, 6-3 
defining, 7-1 
definition, -C=3 
effect on DRAW ARC, 6-8 
ending, 7-2 
in complement mode, 1-17 


INDEX 


Filled figure (Cont.) 
instructions, 1-13 
purpose, 1-5 
shading to line or point, 1-21 
Filled figure attribute 
description, 1-19 
FLUSH BUFFERS 
and END PICTURE, 3-7 
general description, 1-5 
reference description, 3-8 
FORTRAN-77 
PRO/GIDIS instruction names in, 
2-6 
sample program, 2-9 
symbol name restrictions, 2-3 
use of with PRO/GIDIS, 2-1 


=-G= 
GIDIS Output Space 
see GOS 
GIGI 


and ReGIS, 1-2 
Global attribute 
affected by 

SET GIDIS OUTPUT SPACE, 4-5 

and SET OUTPUT IDS, 4-1 
purpose, 1-4 ~— 

Global symmetry 
and SET REL POSITION, 6-2 
definition, C-3 

GOS 
affected by SET OUTPUT IDS, 4-2 
bounds of, 1-8 -_ 
definition, C-3 
description, 1-8 
in viewing transformation, 1-6 
reset state, 3-4 
setting, 4-4 
unit: aspect ratio; I-/ to 1-3 


= = 


Hardware Address Space 
see HAS 
HAS 
definition, C-3 
general description, 1-10 
in viewing transformation, 1-6 
unit aspect ratio, 1-7 


Index-3 


INDEX 


-I- Line texture 
affected by 
I/O Status Block SET GIDIS OUTPUT SPACE, 4-5 
values of, 2-4, 2-6 affected by SET OUTPUT IDS, 4-2 
IDS | definition, C-4_ i 
definition, C-3 description, 1-18 to 1-19 
description, 1-9 reset state, 3-4 to 3-5 
in viewing transformation, 1-6 setting, 5-9 
reset state, 3-3 LOAD CHARACTER CELL 
setting, 4-1 and END LIST, 3-11 
unit aspect ratio, 1-7, 1-9 in alphabet creation, 1-25 
Implied movement parameter block, 2-7 
description, 1-27 reference description, 8-3 
Imposed Device Space Local symmetry 
see IDS definition, C-4 
INITIALIZE in character cell movement, 
and RIS, 2-3 1-29 | 
effect on filled figure, 7-2 
general description, 1-5 -M- 
reference description, 3-1 
Instruction syntax MACRO-11 
description, 2-6, 2-8 PRO/GIDIS instruction names in, 
IO.RSD function code 2-6 
format, 2-5 sample program, 2-8 
in QIO, 2-1 use of with PRO/GIDIS, 2-1 
use of, 1-29, 2-4, 2-6 
IO.WLB function code -N- 
and VT102 Emulator, 2-1 
IO.WSD function code NEW PICTURE 
format, 2-4 general description, 1-5 
ify O10, 2-1 reference description, 3-6 
use of, 2-3 to 2-4 NOP 
IO.WVB function code general description, 1-6 
and VT102 Emulator, 2-1 reference description, 3-10 
Isotropic 
definition, C-4 -O- 
Isotropic mapping 
description, 1-8 Opcode 
IDS to HAS, 1-9 function of, 2-6 
window to viewport, 1-8 Opcode word 
Italic format, 2-6 
see cell rendition Origin 
Gefinition, C-4 
Output space 
definition, C-4 
-L- Overflow 
avoiding, 1-8 
Line Overlay mode 
drawing, 6-3, 6-5 description, 1-1/7 
Line attribute Overlay negate mode 
description, 1-18 description, 1-17 


Index-4 


Ba 0 


Parameter block 
fixed length, 2-7 
format, 2-7 
variable length, 2-7 


INDEX 


ReGIS 
relationship to PRO/GIDIS, 1-2 
when to use, 1-4 

Remote Graphics Instruction Set 
see ReGIS 

Replace mode 


PASCAL description, 1-17 
PRO/GIDIS instruction names in, effect on line texture, 1-19 
2=6 effect on pixel size, 5-8 


Picture aspect ratio 
definition, C-4 
description, 1-8 

Pixel 
addressing individual, 1-12 
definition, C-4 

Pixel aspect ratio 
definition, C-5 

Pixel size 
description, 1-19 
setting, 5-7 

Plane 
definition, C-5 
description, 1-14 

Plane mask 
reset state, 3-5 
setting, 5-4 

Primary color 
definition, C-5 
description, 1-15 
reset state, 3-5 
setting, 5-1 

PRINT SCREEN 
general description, 1-29 
reference description, 9-2 


-Q- 


QOIO 
access to PRO/GIDIS, 2-1, 2-9 
expansion forms, 2-3 
FORTRAN-77 routine, 2-1 

OQIOW 
see QOIO 

Queue I/O Request 
see OIO 


-R= 


Read Special Data 
see IO.RSD 


Replace negate mode 
description, 1-17 
Report 
format, 1-30 
Report handling 
description, 1-29 
Report instruction 
purpose, 1-5 
REQUEST CELL STANDARD 
and IO.RSD, 2-4 
general description, 1-30 
reference description, 10-3 
REQUEST CURRENT POSITION 
and IO.RSD, 2-4 
general description, 1-30 
reference description, 10-1 
REQUEST STATUS 
and IO.RSD, 2-4 
general description, 1-30 
reference description, 10-2 
Reset to Initial State (RIS) 
use of, 2-3 
RIS (Reset) escape sequence 
use of, 2-3 


-S=— 


Screen 
printing; 9=2 
Scrolling 
by VT102 Emulator, 2-3 
SD.GDS parameter 
use of, 2-4 to 2-5 
Secondary color 
definition, C-5 
description, 1-15 
reset state, 3-5 
setting, 5-2 
Secondary color and NEW PICTURE, 
3-6 
SET ALPHABET 
general description, 1-24 


Index-5 


SET ALPHABET (Cont. ) 

in alphabet creation, 1-25 

reference description, 8-2 
SET AREA CELL SIZE 

general description, 1-21 

reference description, 5-12 
SET AREA TEXTURE 

effect on area cell size, 5-12 

general description, 1-20 

reference description, 5-10 
SET AREA TEXTURE SIZE 

general description, 1-20 

reference description, 5-1ll 
SET CELL DISPLAY SIZE 

general description, 1-27 

reference description, 8-8 
SET CELL EXPLICIT MOVEMENT 

general description, 1-27 

reference description, 8-10 
SET CELL MOVEMENT MODE 

general description, 1-27 

reference description, 8-9 
SET CELL OBLIQUE 

general description, 1-27 

reference description, 8-6 
SET CELL RENDITION 

general description, 1-26 

reference description, 8-4 
SET CELL ROTATION 

general description, 1-26 

reference description, 8-6 
SET CELL UNIT SIZE 

general description, 1-27 

reference description, 8-7 
SET COLOR MAP ENTRY 

general description, 1-15 

reference description, 5-3 
SET GIDIS OUTPUT SPACE 

effect on clipping region, 1-9 

invalid in filled figure, 7-2 

purpose, 1-8 

reference description, 4-4 
SET LINE TEXTURE 

general description, 1-18 

reference description, 5-9 
SET OUTPUT CLIPPING REGION 

general description, 1-9 

reference description, 4-6 
SET OUTPUT CURSOR 

general description, 1-5 

reference description, 3-8 


INDEX 


SET OUTPUT IDS 
general description, 1-9 
invalid in filled figure, 7-2 
reference description, 4-1 
SET OUTPUT VIEWPORT 
general description, 1-10 
invalid in filled figure, 7-2 
reference description, 4-3 
SET PIXEL SIZE 
effect on line texture, 1-19 
general description, 1-19 
reference description, 5-7 
SET PLANE MASK 
and VT102 Emulator, 2-3 
general description, 1-15 
reference description, 5-4 
SET POSITION 
general description, 1-13 
invalid in filled figure, 7-2 
reference description, 6-1 
SET PRIMARY COLOR 
general description, 1-15 
reference description, 5-1 
SET REL POSITION 
general description, 1-13 
invalid in filled figure, 7-2 
reference description, 6-2 
SET SECONDARY COLOR 
general description, 1-15 
reference description, 5-2 
SET WRITING MODE 
reference description, 5-7 
Standard display size 
Gefinition, C-5 
reporting, 1-30 
Standard unit size 
definition, C-5 
reporting, 1-30 
Status 
in error condition, 2-7 
reporting, I=30,. 20=2 
SYSLIB 
as source of OIO routine, 2-1 
module QIOSYM, 2-3 
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Terminal emulator 
see VT1O2 Emulator 
see VT125 Emulator 


Index-6 


Text 
instruction, 1-14 
Text attribute 
description, 1-24 


Text instruction 
purpose, 1-5 

Transparent mode 
description, 1-16 

Transparent negate mode 
description, 1-16 
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Unit aspect ratio 
description, 1-7 
of GOS, 1-7 to 1-8 
of HAS, 1-7 
of IDS, 1-7 

Unit cell 
Gefinition, 
reporting, 


C25 
L035 
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Video monitor 
color, 1-11 
monochrome, 1-10 

Viewing transformation 
definition, C-6 
description, 1-6, 
process, l1-l1l 
purpose, 1-4 


L=12 


INDEX 


Index-/7 


Viewport 
atfected. by SET OUTPUT LDS, 4-2 
definition, C-6 — 
description, 1-10 
in viewing transformation, 1-7 
reset state, 3-4 
setting, 4-3 
VT102 Emulator 
interaction with PRO/GIDIS, 2-2 
to 2-3 
use of planes, 5-5 
use of with PRO/GIDIS, 2-1 
VT125 Emulator 
use of, 1-4 
VT125 terminal 
and ReGIS, 1-2 


-W= 


Window 
and clipping region, 
definition, C-6 
description, 1-8 
in Viewing Transformation, 1-7 
Write Special Data 
see [0O.WSD 
Writing mode 
see also individual modes 
description, 1-15, 1-18 
interaction with plane mask, 
5-5 
reset state, 3-5 
setting, 5-7 
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READER’S COMMENTS 


NOTE: This form is for document comments only. DIGITAL 
will use Comments submitted on this form at the com- 
pany's discretion. If you require a written reply and 
are eligible to receive one under Software Perfor- 
mance Report (SPR) service, submit your comments 
on an SPR form. 


Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 


Did you find errors in this manual? If so, specify the error and the page number. 


Please indicate the type of reader that you most nearly represent. 
(J Assembly language programmer 
(J Higher-level language programmer 
L] Occasional programmer (experienced) 
CJ User with little programming experience 
L] Student programmer 
_] Other (please specify) 


Name Date 


Organization 

Street 

City | State st tCtC—“‘(‘SSCONZI:NM COW’ 
or 


Country 
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